You can run a self-contained MCP server that connects to the Jules API to create coding tasks, schedule recurring work, monitor progress, and approve plans. It uses a local scheduling engine to keep tasks running across restarts, so you can automate maintenance and keep Jules working for you without keeping an IDE open.

How to use

Use the MCP client to interact with Jules through natural language prompts. You can create immediate coding tasks, schedule recurring work, view session status, and review or approve generated plans. The server exposes read-only resources for context and a set of tools to perform actions programmatically.

How to install

# Prerequisites
Node.js 18.0.0 or higher
Jules API Key
GitHub Repositories connected to Jules via the web UI

# Setup
# Clone or download this repository
cd jules-mcp

# Install dependencies
npm install

# Build TypeScript
npm run build

# Set your API key
export JULES_API_KEY="your-key-here"

# Test the server
npm start

Quick smoke test

npm run mcp:smoke

Expected output validates API calls and basic tool prompts.

Global installation makes the MCP server available as a command-line tool for everyday use.

## Configuration and startup basics

Configure authentication and access controls to ensure safe operation.

Environment variables

export JULES_API_KEY="your-key-here" export JULES_ALLOWED_REPOS="owner/repo1,owner/repo2" # optional export JULES_DEFAULT_BRANCH=main # optional

Claude Desktop and VS Code/Cursor integration examples are provided to wire the MCP server into your editor or assistant.

Security considerations

Protect your Jules API key and restrict repository access with an allowlist to prevent unauthorized changes.

Enable plan approvals for critical repositories to ensure human review before code changes.

Troubleshooting

If you see errors about the API key or repository access, verify the key is set correctly and that repos are properly connected in Jules.

Ensure the local schedule storage file exists and is writable to persist recurring tasks.

Run type checks during development to catch TypeScript issues.

Development

Project structure separates types, API client, persistence, scheduling, and MCP protocol layers to keep concerns clean.

npm run build      # Compile TypeScript
npm run dev        # Development mode with tsx
npm run typecheck  # Type checking only

The main entry point is index.ts, which wires together the MCP protocol with Jules API calls.

## Available tools

### create\_coding\_task

Create an immediate Jules coding session with a natural language prompt, target repository, and optional settings like branch and PR creation.

### manage\_session

Manage active sessions, including approving generated plans or sending messages to refine work.

### get\_session\_status

Check the status of a Jules session and determine next steps.

### schedule\_recurring\_task

Schedule a recurring Jules task using a cron expression, including prompt, source, and optional parameters like timezone and PR behavior.

### list\_schedules

List all active scheduled tasks along with their next run times.

### delete\_schedule

Remove a scheduled Jules task by name.