Unofficial Jules MCP Server

jules-mcp-server connects your AI coding assistant (such as Claude, Cursor, or Copilot) to the Jules API, enabling autonomous coding sessions directly from your IDE. It acts as a Model Context Protocol (MCP) server, giving your AI assistant the ability to create coding sessions, manage tasks, and interact with Jules agents for automated software development.

Changelog | Troubleshooting

Key features

• Autonomous coding sessions: Create and manage Jules coding sessions directly from your AI assistant
• GitHub integration: Connect to your GitHub repositories through Jules sources
• Plan approval workflow: Review and approve execution plans before Jules makes changes
• Real-time activity tracking: Monitor session progress and view detailed activity logs
• Type-safe validation: Runtime validation with Zod ensures all inputs are validated before API calls
• Streamable HTTP transport: Uses the MCP Streamable HTTP specification for reliable communication

Disclaimers

jules-mcp-server provides your MCP client with access to create and manage coding sessions in your connected GitHub repositories. Ensure you review and approve plans before execution, especially in production repositories. The server requires a valid Jules API key with appropriate permissions.

Requirements

• Node.js v18 or newer
• Jules API account with API key
• npm

Getting started

1. Clone and install

git clone https://github.com/yourusername/jules-mcp-server.git
cd jules-mcp-server
npm install

2. Configure environment

cp .env.example .env
# Edit .env and add your JULES_API_KEY

Your .env file should contain:

JULES_API_KEY=your_api_key_here
PORT=3323
HOST=127.0.0.1

3. Start the server

npm run dev
# Server starts at http://127.0.0.1:3323/mcp

For production:

npm run build
npm run start:node

4. Configure your MCP client

Add the following config to your MCP client:

{
  "mcpServers": {
    "jules": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:3323/mcp"
    }
  }
}

[!IMPORTANT]
The Jules MCP server uses Streamable HTTP transport and must be running before connecting your MCP client. Unlike stdio-based servers, this server runs as a persistent HTTP service.

MCP Client configuration

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json