README.md
jules-api-mcp
An MCP server for Jules — Google's AI coding agent. Manage Jules sessions from any MCP-compatible client: Claude, Gemini CLI, Cursor, Zed, VS Code, and more.
Tools
| Tool | Description |
|---|---|
list_sessions |
List all Jules sessions |
get_session |
Get session details and current state |
create_session |
Create a new Jules session |
approve_plan |
Approve Jules's plan to proceed with execution |
send_message |
Send feedback or instructions to Jules |
list_activities |
Full activity timeline for a session |
get_last_message |
Jules's latest outbound message |
get_pr_url |
Get the PR URL from a completed session |
Requirements
- Node.js 18+
- A Jules API key (
JULES_API_KEY)
Installation
From source
git clone https://github.com/GreyC/jules-api-mcp
cd jules-api-mcp
npm install
npm run build
Configuration
Add to your MCP client config (e.g. ~/.claude/claude_desktop_config.json or ~/.gemini/settings.json):
{
"mcpServers": {
"jules": {
"command": "node",
"args": ["/path/to/jules-api-mcp/dist/index.js"],
"env": {
"JULES_API_KEY": "<your-key>"
}
}
}
}
Usage Examples
List all sessions:
list_sessions()
Create a session with auto PR:
create_session(
repo="owner/repo",
prompt="Refactor the login function in auth.py to use async/await",
automation_mode="AUTO_CREATE_PR"
)
Approve a plan:
approve_plan(session_id="<ID>")
Send feedback:
send_message(session_id="<ID>", message="Looks good, please create the PR.")
Session States
| State | Meaning |
|---|---|
IN_PROGRESS |
Jules is actively working |
AWAITING_PLAN_APPROVAL |
Jules generated a plan, waiting for approval |
AWAITING_USER_FEEDBACK |
Jules has a question mid-execution |
COMPLETED |
Jules finished |
FAILED |
Unrecoverable error |
Related
- jules-skill — Agent skill with workflow guidance, decision heuristics, and prompt templates for autonomous Jules management
License
MIT
Tools 8
list_sessionsList all Jules sessionsget_sessionGet session details and current statecreate_sessionCreate a new Jules sessionapprove_planApprove Jules's plan to proceed with executionsend_messageSend feedback or instructions to Juleslist_activitiesFull activity timeline for a sessionget_last_messageJules's latest outbound messageget_pr_urlGet the PR URL from a completed sessionEnvironment Variables
JULES_API_KEYrequiredAPI key for accessing Jules servicesTry it
→List all my active Jules coding sessions.
→Create a new Jules session for repository owner/repo to refactor the authentication module.
→Approve the current execution plan for session ID <ID>.
→Send a message to Jules in session <ID> asking it to prioritize the bug fix over the refactor.
→Get the PR URL for my most recently completed Jules session.