Jules MCP Server

Creates a new Jules session or automated run to perform code tasks. If repo and branch are omitted, creates a "repoless" session where the user provides their own context in the prompt and Jules will perform code tasks based on that context instead of a GitHub repo.

List recent Jules sessions with pagination support.

Get the current status of a Jules session. Acts as a dashboard to determine if Jules is busy, waiting, or failed.

RETURNS: id, status, url, title, prompt, pr (if created), lastActivity, lastAgentMessage (if any), pendingPlan (if awaiting approval)

STATUS (use this to decide what action to take):

• "busy": Jules is actively working. Peek with get_code_review_context if needed.

• "stable": Work is paused. Safe to review code, send messages, or check outputs.

• "failed": System-level failure (like a 500). Session cannot continue.

LAST ACTIVITY:

• Shows what just happened (activityId, type, timestamp)

• Common types: agentMessaged, sessionCompleted, progressUpdated, userMessaged, planGenerated

LAST AGENT MESSAGE:

• Contains the last message Jules sent (activityId, content, timestamp)

• Read this to understand what Jules communicated

• If Jules asked a question, you can respond using send_reply_to_session

PENDING PLAN:

• Present when a plan is awaiting approval (lastActivity.type is 'planGenerated')

• Contains planId and steps (title, description for each step)

• Use send_reply_to_session with action 'approve' to approve the plan

NEXT ACTIONS:

• busy → Wait for completion, or peek with get_code_review_context

• stable + pendingPlan → Review the plan steps, then approve or send feedback

• stable + lastAgentMessage → Read message, respond if Jules asked something

• stable + no message → Review PR or code changes with get_code_review_context

• failed → Report to user. Session is unrecoverable.

IMPORTANT:

• You can send messages to ANY session regardless of status.

• A session is never truly "done" unless it's failed. You can always continue the conversation.

Interacts with an active Jules session (approving plans or sending messages).

Review code changes from a Jules session. Returns a structured summary of what changed, organized by file with change types, line counts, and activity IDs. Automatically detects if session is busy (aggregates from activities) or stable (uses final outcome). Can optionally scope to a single activity. For detailed diffs, use show_code_diff.

Show the actual code diff for files from a Jules session. Returns unified diff format that can be displayed to users. Use after get_code_review_context to drill into specific file changes. Can optionally show diff from a specific activity (use activity IDs from get_code_review_context output).

Query the LOCAL CACHE of sessions and activities. Returns only previously synced data (fast, but may be stale). To ensure fresh data: call jules_sync first, then jules_select. Best for searching across multiple sessions or filtering by type/state.

Get all bash command outputs from a Jules session. Returns commands executed, their stdout/stderr, and exit codes. Use to understand what shell commands were run.

Lists all GitHub repositories connected to your Jules account.

Gets details about a specific GitHub repository connected to Jules.

Creates a new Jules session to perform an asynchronous coding task.

Gets the current status and details of a Jules session.

Lists your Jules sessions with optional pagination.

Approves the current plan for a session.

Rejects the current plan for a session and optionally provides feedback.

Sends a message to an active Jules session.

Cancels an active Jules session.

Lists all activities (events) in a Jules session.

Gets the most recent activity from a Jules session.

Gets the execution plan from a Jules session.

Waits for a Jules session to complete (success, failure, or cancellation).

Waits for Jules to generate a plan for a session.

Creates a Jules session AND waits for it to complete in a single operation.

Simplest way to assign a task to Jules with sensible defaults.

Gets a comprehensive summary of a Jules session including status, plan, activities, and outputs.

Applies the latest Jules diff to a local git working tree (syncs the codebase).