🗺️ 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 agent to control the 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 Google Jules API, it provides the bridge between your IDE and a distributed team of AI workers.
[!TIP] Use IDE agents to analyse and assign tasks to Jules to get best output from this MCP.
🚀 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.
🌟 Support
If Jules MCP helps you build faster, please consider:
- ⭐️ Starring the GitHub Repository
- 👤 Following TheRealAshik for updates.
Developed with ❤️ by TheRealAshik