Jules
Unofficial MCP server for Google Jules agent 🐙
What is Jules?
Jules is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unofficial mcp server for google jules agent 🐙
Unofficial MCP server for Google Jules agent 🐙
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Unofficial MCP server for Google Jules agent 🐙
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx julesConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Jules
The Jules MCP server is an unofficial integration that exposes Google's Jules autonomous coding agent to any MCP-compatible AI client, including Claude. It wraps the Jules API with tools for managing code sources, creating and monitoring agent sessions, approving execution plans, and sending messages to running sessions — enabling developers to orchestrate Jules coding tasks directly from their AI assistant without switching to the Jules web interface. It requires Python 3.13+ and a Jules API key.
Prerequisites
- Python 3.13 or later
- uv package manager (recommended) or pip
- A Google Jules API key (JULES_API_KEY)
- An MCP-compatible client such as Claude Desktop or Claude Code
Clone the repository
Clone the jules-mcp-server repository to your local machine.
git clone https://github.com/CodeAgentBridge/jules-mcp-server
cd jules-mcp-serverInstall dependencies
Install the project using uv (recommended) or pip in editable mode.
# With uv (recommended)
uv sync
# Or with pip
pip install -e .Set your Jules API key
Export your Jules API key as an environment variable. The SDK reads JULES_API_KEY automatically.
# Bash/Zsh
export JULES_API_KEY="your_api_key_here"
# PowerShell
$Env:JULES_API_KEY = "your_api_key_here"Run the server to verify it starts
Test that the server launches correctly using the fastmcp entry point.
uv run fastmcp run jules_mcp/jules_mcp.py:mcp
# or
python -m jules_mcpAdd to Claude Desktop configuration
Register the server in Claude Desktop's config file, passing the API key as an environment variable.
{
"mcpServers": {
"jules": {
"command": "uv",
"args": ["run", "--directory", "/path/to/jules-mcp-server", "fastmcp", "run", "jules_mcp/jules_mcp.py:mcp"],
"env": {
"JULES_API_KEY": "your_api_key_here"
}
}
}
}Jules Examples
Client configuration
Claude Desktop JSON configuration for the Jules MCP server using uv.
{
"mcpServers": {
"jules": {
"command": "uv",
"args": [
"run",
"--directory", "/path/to/jules-mcp-server",
"fastmcp", "run", "jules_mcp/jules_mcp.py:mcp"
],
"env": {
"JULES_API_KEY": "your_jules_api_key"
}
}
}
}Prompts to try
Example prompts for interacting with Google Jules sessions via the MCP server.
- "List all available Jules sources"
- "Create a Jules session for source 'sources/abc123' with the prompt: analyze the codebase and identify potential performance bottlenecks"
- "Show me all active Jules sessions"
- "Approve the execution plan for Jules session 'sessions/xyz789'"
- "Send a message to Jules session 'sessions/xyz789': please also add unit tests for the changes you made"
- "Wait for Jules session 'sessions/xyz789' to complete and show me the results"Troubleshooting Jules
Python version error — requires Python 3.13+
This server requires Python 3.13 or later. Check your version with 'python --version'. Install Python 3.13+ from python.org or use pyenv: 'pyenv install 3.13.0 && pyenv local 3.13.0'. With uv, run 'uv python install 3.13' then 'uv sync'.
JULES_API_KEY not found or authentication fails
Ensure the JULES_API_KEY environment variable is set in the env block of your MCP client config, not just in your shell profile (shell env vars are not automatically inherited by MCP clients). Verify the key is valid by testing it directly with the Jules API documentation.
uv command not found
Install uv with the official installer: 'curl -LsSf https://astral.sh/uv/install.sh | sh' (macOS/Linux) or 'powershell -c irm https://astral.sh/uv/install.ps1 | iex' (Windows). Alternatively, use 'pip install -e .' and replace the uv run command with 'python -m jules_mcp' in your config.
Frequently Asked Questions about Jules
What is Jules?
Jules is a Model Context Protocol (MCP) server that unofficial mcp server for google jules agent 🐙 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Jules?
Follow the installation instructions on the Jules GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Jules?
Jules works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Jules free to use?
Yes, Jules is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Jules Alternatives — Similar Coding Agents Servers
Looking for alternatives to Jules? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Jules in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Jules?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.