iflow-mcp_codeagentbridge-jules-mcp

# Jules MCP Server (jules-mcp) An MCP (Model Context Protocol) server that exposes Google Jules Agent operations via FastMCP. This server lets MCP-compatible clients (and Python code) list Jules sources, create and manage sessions, and inspect activities using the official jules-agent-sdk. - Server framework: FastMCP - SDK: jules-agent-sdk - Python: 3.13+ - License: Apache-2.0 ## Features Tools exposed via the MCP server (grouped by area): - Sources - get_source(source_id) - list_sources(filter_str=None, page_size=None, page_token=None) - get_all_sources(filter_str=None) - Sessions - create_session(prompt, source, starting_branch=None, title=None, require_plan_approval=False) - get_session(session_id) - list_sessions(page_size=None, page_token=None) - approve_session_plan(session_id) - send_session_message(session_id, prompt) - wait_for_session_completion(session_id, poll_interval=5, timeout=600) - Activities - get_activity(session_id, activity_id) - list_activities(session_id, page_size=None, page_token=None) - list_all_activities(session_id) See jules_mcp/jules_mcp.py for signatures and inline docstrings. ## Installation Option A — from a local checkout: ```bash # from the repository root pip install -e . ``` Option B — using uv (recommended during development): ```bash # from the repository root uv sync ``` The project targets Python 3.13+. ## Configuration Set your Jules API key via environment variable: - Windows PowerShell ```powershell $Env:JULES_API_KEY = "<your_api_key_here>" ``` - Unix shells (bash/zsh) ```bash export JULES_API_KEY="<your_api_key_here>" ``` If you do not provide an argument to jules(), the SDK reads JULES_API_KEY automatically. ## Running the MCP server There are two common ways to run the server. 1) Programmatic run (in-process) using FastMCP Client — useful for testing or embedding: ```python import asyncio from fastmcp import Client from jules_mcp import mcp async def main(): …