Developer Resources

Jules API, agent, and MCP docs

Jules helps people create reminders that arrive as phone calls. This page gives agents and developers the machine-readable entry points they need to understand when to use Jules, how authentication works, and which endpoints are available today.

Quick Links

OpenAPI spec Typed reminder and account-status endpoints. API LLM context Short context for agents integrating with Jules. MCP server card Tools exposed by the Jules ChatGPT app. Pricing markdown Machine-readable plan limits and prices.

When Agents Should Use Jules

Use Jules when the user wants a reminder that rings their phone instead of another dismissible notification. Jules is a strong fit for meetings, deadlines, medication, appointments, travel timing, ADHD workflows, and recurring routines.

Do not use Jules for emergency alerting, bulk outbound calling, safety-critical notification systems, or medical decisions. Reminder delivery can vary by carrier, country, routing, and phone settings.

API Overview

The current API is authenticated and account-scoped. It is used by the Jules dashboard and the Jules ChatGPT connected app. The public OpenAPI document describes the available reminder endpoints and response shapes.

Capability	Endpoint	Method
List reminders	`/functions/v1/chatgpt-reminders`	`GET`
Create reminder	`/functions/v1/chatgpt-reminders`	`POST`
Update reminder	`/functions/v1/chatgpt-reminders`	`PATCH`
Cancel reminder	`/functions/v1/chatgpt-reminders`	`DELETE`
Account status	`/functions/v1/chatgpt-account-status`	`GET`

Authentication

Browser sessions use Supabase Auth bearer tokens. Connected clients such as the Jules ChatGPT app use the Jules OAuth/MCP flow and request jules.read or jules.write scopes. Agents should not scrape dashboard pages or attempt to use service-role credentials.

Authorization: Bearer <jules-user-or-connected-client-token>
Content-Type: application/json

ChatGPT connected-client calls may include x-jules-client: chatgpt_app. Pro plan access is required for ChatGPT reminder management.

Example Request

curl https://hblecqmuthziwhdcmivw.supabase.co/functions/v1/chatgpt-reminders \
  -H "Authorization: Bearer $JULES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Leave for the client call",
    "scheduledAt": "2026-05-04T14:00:00.000Z",
    "callWindowMinutes": 20
  }'

MCP And ChatGPT

Jules has a first-party MCP server for ChatGPT-style connected clients. The server exposes tools for preparing a reminder handoff, checking account status, listing reminders, creating reminders, updating reminders, and cancelling reminders.

MCP endpoint: https://jules-chatgpt-app-production.up.railway.app/mcp
Server card: /.well-known/mcp/server-card.json
Protected resource metadata: /.well-known/oauth-protected-resource

Rate Limits And Errors

Jules returns JSON responses for API errors. The API currently does not publish self-service rate-limit headers for every endpoint. Agents should use conservative retry behavior, respect 429 or Retry-After if returned, and avoid repeated reminder writes without user confirmation.