Jules MCP Server
MCP (Model Context Protocol) server for Google Jules, the asynchronous AI coding agent. This server enables LLMs to create Jules sessions with automatic pull request creation.
Features
- Auto-PR Creation: Sessions automatically create pull requests when complete
- Issue Integration: Create sessions directly from GitHub issues
- Session Management: List and monitor your Jules sessions
Installation
npm install -g @anthropic/jules-mcpOr run directly with npx:
npx @anthropic/jules-mcpConfiguration
Environment Variables
| Variable | Required | Description | |----------|----------|-------------| | JULES_API_KEY | Yes | Jules API key from Google AI Studio | | GITHUB_TOKEN | No | GitHub token for fetching issue details (optional but recommended) |
Claude Code
Add to ~/.config/ccs/mcp.toml:
[servers.jules]
command = "npx @anthropic/jules-mcp"
[servers.jules.env]
JULES_API_KEY = "env://JULES_API_KEY"
GITHUB_TOKEN = "env://GITHUB_TOKEN"Claude Desktop
Add to your Claude Desktop config:
{
"mcpServers": {
"jules": {
"command": "npx",
"args": ["@anthropic/jules-mcp"],
"env": {
"JULES_API_KEY": "your-api-key"
}
}
}
}Tools
create_session
Create a new Jules coding session.
Parameters:
repo(required): GitHub repository inowner/repoformatprompt(required): Task description for Julesauto_pr(optional, default: true): Automatically create a PR when donestarting_branch(optional): Branch to start fromtitle(optional): Session title
Example: ``json { "repo": "myorg/myrepo", "prompt": "Add input validation to the login form", "auto_pr": true } ``
create_session_from_issue
Create a session directly from a GitHub issue.
Parameters:
repo(required): GitHub repository inowner/repoformatissue_number(required): GitHub issue numberadditional_context(optional): Extra instructions
Example: ``json { "repo": "myorg/myrepo", "issue_number": 42 } ``
list_sessions
List your Jules sessions.
Parameters:
limit(optional, default: 10): Maximum sessions to return
get_session
Get details of a specific session.
Parameters:
session_id(required): The session ID
Development
# Install dependencies
npm install
# Build
npm run build
# Run locally
JULES_API_KEY=your-key node dist/index.jsLicense
MIT
