⚠️ 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.
[!IMPORTANT] Visit jules.google.com/settings/api to generate your credentials before proceeding.
🤖 Method 1: Agent-Driven Install (Recommended)
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.
👤 Method 2: Manual Self-Install
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
Click to expand features list
- 🎭 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.
🌟 Support
If Jules MCP helps you build faster, please consider:
- ⭐️ Starring the GitHub Repository
- 👤 Following TheRealAshik for updates.
Developed with ❤️ by TheRealAshik
Environment Variables
JULES_API_KEYrequiredAPI key for authenticating with the Google Jules API