Add it to Claude Code
claude mcp add -e "JULES_API_KEY=${JULES_API_KEY}" jules-mcp-914a -- npx -y @realashik/jules-mcpJULES_API_KEYMake your agent remember this setup
jules-mcp-914a's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Multi-Role Orchestration of MAESTRO, CREW, FREELANCER, and EVALUATOR agents
- Staged workflows for managing git branches and code generation
- Global shared memory for cross-session variable and context passing
- Real-time activity streaming using the official Google Jules SDK
- Automated quality enforcement and review cycles
Environment Variables
JULES_API_KEYrequiredAPI key for authenticating with the Google Jules APITry it
Original README from TheRealAshik/jules-mcp
⚠️ Deprecated Notice
Jules MCP is now deprecated. Google Labs has released their official Jules SDK with native Model Context Protocol (MCP) support, making this community package obsolete.
🗺️ Navigation
⚙️ Setup
Choose the installation method that fits your workflow. Both methods require a Jules API Key.
<details> <summary><b>🤖 Method 1: Agent-Driven Install (Recommended)</b></summary>[!IMPORTANT] Visit jules.google.com/settings/api to generate your credentials before proceeding.
The fastest way to get started. Copy the block below and paste it into your AI assistant (Antigravity, Cursor, or Claude).
Read https://raw.githubusercontent.com/TheRealAshik/jules-mcp/refs/heads/main/docs/AGENT_INSTALL.md and do as per the instructions.
If you prefer to configure the server yourself, follow these steps:
Locate your config file:
- Antigravity:
~/.gemini/antigravity/mcp_config.json - Claude Desktop:
%APPDATA%\Claude\claude_desktop_config.json - Cursor: Settings > Features > MCP > Add New Server
- Antigravity:
Add the following snippet:
{
"mcpServers": {
"jules-mcp": {
"command": "npx",
"args": ["-y", "@realashik/jules-mcp"],
"env": {
"JULES_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
📖 Overview
Jules MCP is a Model Context Protocol (MCP) server designed to supercharge AI coding agents to control Jules. While standard AI agents are limited to linear task execution, Jules MCP introduces Staged Orchestration—enabling a "Commander" agent to deploy multiple specialized sub-agents (Maestros, Crews, Freelancers) to handle distinct parts of a project simultaneously or in sequence.
Built on top of the official @google/jules-sdk, it provides the bridge between your IDE and a distributed team of AI workers with advanced features like real-time streaming, session management, and intelligent caching.
[!TIP] Use IDE agents to analyse and assign tasks to Jules to get best output from this MCP.
[!NOTE] v1.0.4+ now uses the official Google Jules SDK for improved reliability, streaming support, and better error handling.
🚀 Features
<details> <summary><b>Click to expand features list</b></summary>- 🎭 Multi-Role Orchestration: Spawn
MAESTRO(Architect),CREW(Implementer),FREELANCER(Specialist), orEVALUATOR(Quality Control). - 📝 Staged Workflows: Automatically manage git branches, code generation, and merging in a single, safe flow.
- 🧠 Global Shared Memory: Cross-session memory allows workers to pass variables and context like biological collaborators.
- 🛡️ Quality Enforcement: Built-in review cycles ensure code meets security and performance standards before merging.
- ⚡ Zero Configuration: Instantly usable via
npxwith automatic environment discovery. - 🌊 Real-time Streaming: Stream live activity updates from Jules sessions using the official SDK.
- 🔄 Session Management: Simplified session lifecycle with automatic polling and state management.</details>
🌟 Support
If Jules MCP helps you build faster, please consider:
- ⭐️ Starring the GitHub Repository
- 👤 Following TheRealAshik for updates.
Developed with ❤️ by TheRealAshik