README.md
Automate Google Jules for task creation, code analysis, and AI workflows.
Google Jules MCP
A Model Context Protocol (MCP) server for automating Google Jules - the AI coding assistant. This MCP enables seamless integration with Jules for task creation, code review automation, repository management, and AI-powered development workflows.
Features
🎯 **Task Management**
- Create Tasks: Automatically create Jules tasks with repository and description
- Monitor Progress: Track task status and get real-time updates
- Approve Plans: Review and approve Jules execution plans
- Resume Tasks: Resume paused or interrupted tasks
- Bulk Operations: Create multiple tasks efficiently
🔧 **Code Operations**
- Code Analysis: Analyze code changes and diffs
- Branch Management: Handle repository branches and configurations
- Source Navigation: Browse and analyze source files
- Review Automation: Automate code review workflows
💬 **Interactive Communication**
- Send Messages: Send instructions and feedback to Jules
- Chat History: Track conversation history with Jules
- Context Extraction: Extract relevant context from task discussions
📊 **Project Management**
- Task Listing: List and filter tasks by status
- Progress Tracking: Monitor development progress across projects
- Data Persistence: Local storage of task data and history
🔐 **Session Management** (NEW!)
- Multiple Session Modes: Fresh, Chrome profile, cookies, persistent, and Browserbase
- Google Authentication: Seamless login with existing Google sessions
- Cookie Management: Extract, save, and restore authentication cookies
- Remote Browser Support: Use Browserbase for cloud deployments
- Cross-Platform: Works locally and in cloud environments
Available Tools
| Tool | Description |
|---|---|
| Task Management | |
jules_create_task |
Create a new Jules task with repository and description |
jules_get_task |
Get detailed information about a specific task |
jules_send_message |
Send messages/instructions to Jules in active tasks |
jules_approve_plan |
Approve Jules execution plans |
jules_resume_task |
Resume paused tasks |
jules_list_tasks |
List tasks with filtering options |
jules_analyze_code |
Analyze code changes and project structure |
jules_bulk_create_tasks |
Create multiple tasks from a list |
| Session & Authentication | |
jules_get_cookies |
Get current browser cookies for session persistence |
jules_set_cookies |
Set browser cookies from string/JSON for authentication |
jules_session_info |
Get current session configuration and status |
| Debugging | |
jules_screenshot |
Take debugging screenshots |
Installation
Prerequisites
- Node.js 18+
- TypeScript
- Git access to repositories you want to manage
Setup
# Clone the repository
git clone https://github.com/samihalawa/google-jules-mcp.git
cd google-jules-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Test the installation
npm test
🔐 Session Management & Authentication
Session Modes
The MCP supports 5 different session management modes:
| Mode | Description | Use Case |
|---|---|---|
fresh |
New browser session each time | Testing, no authentication needed |
chrome-profile |
Use existing Chrome profile | Local development with existing Google login |
cookies |
Save/load cookies to file | Persistent authentication without full profile |
persistent |
Save browser data to directory | Local development with full session persistence |
browserbase |
Remote browser session | Cloud deployments, Smithery hosting |
Configuration Options
🌐 **Browserbase (Recommended for Smithery)**
Perfect for remote deployments and cloud hosting:
SESSION_MODE=browserbase
BROWSERBASE_API_KEY=bb_live_g3i-b4WPFh__E3cErKE5rO-jWds # Your API key
BROWSERBASE_PROJECT_ID=d718e85f-be7b-497d-9123-b1bbf798f1bb # Your project ID
BROWSERBASE_SESSION_ID= # Optional: use existing session
🍪 **Cookie Authentication (Best for Manual Setup)**
Extract cookies from your browser and set them as environment variable:
SESSION_MODE=cookies
GOOGLE_AUTH_COOKIES="session_id=abc123; domain=.google.com; auth_token=xyz789; domain=.google.com"
COOKIES_PATH=~/.jules-mcp/cookies.json # File to save/load cookies
🌍 **Chrome Profile (Local Development)**
Use your existing Chrome profile:
SESSION_MODE=chrome-profile
CHROME_USER_DATA_DIR=/Users/yourname/Library/Application Support/Google/Chrome/Default
💾 **Persistent Browser Data**
Save browser data to a specific directory:
SESSION_MODE=persistent
CHROME_USER_DATA_DIR=~/.jules-mcp/browser-data # Custom browser data directory
How to Get Google Authentication Cookies
- Log in to Jules: Visit https://jules.google.com and log in
- Open Developer Tools: Press F12 or Cmd+Option+I 3
Tools (12)
jules_create_taskCreate a new Jules task with repository and descriptionjules_get_taskGet detailed information about a specific taskjules_send_messageSend messages/instructions to Jules in active tasksjules_approve_planApprove Jules execution plansjules_resume_taskResume paused tasksjules_list_tasksList tasks with filtering optionsjules_analyze_codeAnalyze code changes and project structurejules_bulk_create_tasksCreate multiple tasks from a listjules_get_cookiesGet current browser cookies for session persistencejules_set_cookiesSet browser cookies from string/JSON for authenticationjules_session_infoGet current session configuration and statusjules_screenshotTake debugging screenshotsEnvironment Variables
SESSION_MODErequiredSession management mode (fresh, chrome-profile, cookies, persistent, browserbase)BROWSERBASE_API_KEYAPI key for Browserbase cloud deploymentsBROWSERBASE_PROJECT_IDProject ID for Browserbase cloud deploymentsGOOGLE_AUTH_COOKIESAuthentication cookies for Google sessionCHROME_USER_DATA_DIRPath to Chrome user data directory for profile persistenceConfiguration
claude_desktop_config.json
{"mcpServers":{"google-jules":{"command":"node","args":["/path/to/google-jules-mcp/build/index.js"],"env":{"SESSION_MODE":"browserbase","BROWSERBASE_API_KEY":"your_api_key","BROWSERBASE_PROJECT_ID":"your_project_id"}}}}Try it
→Create a new Jules task to refactor the authentication logic in the 'backend-api' repository.
→List all my current Jules tasks and show me the status of the 'database-migration' task.
→Approve the execution plan for Jules task ID 12345.
→Send a message to Jules in task 67890 asking it to focus on unit test coverage for the new utility functions.
→Analyze the code changes in the current repository and give me a summary of the diff.