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

jules-skill — Agent skill with workflow guidance, decision heuristics, and prompt templates for autonomous Jules management

License

MIT

Jules API MCP