FocusFlow Home

Guide · MCP

Connect Claude, ChatGPT & Cursor to FocusFlow via MCP

Step-by-step guide to configuring FocusFlow as an MCP server so Claude, ChatGPT, and Cursor can create, schedule, and complete your tasks.

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external tools and data sources. An MCP server exposes a set of tools an agent can call — like create_task, list_available, or complete_task — over a well-defined transport. Instead of copy-pasting plans into ChatGPT or asking Claude to remember what you said yesterday, your AI talks directly to your task database.

Why FocusFlow ships as an MCP server

FocusFlow exposes the same tools we use internally — capture, tag, defer, complete, weekly review — as MCP tools. Any MCP-compatible agent (Claude Desktop, ChatGPT with custom connectors, Cursor, Zed, Windsurf) can run them on your account. You get a single source of truth and let the AI operate on it directly.

Step 1 — Grab your MCP endpoint

Sign in to FocusFlow and open Settings → Integrations. Copy the MCP endpoint URL and your personal access token. The endpoint is scoped to your workspace.

Step 2 — Connect Claude Desktop

Open Claude Desktop's claude_desktop_config.json and add:

{
  "mcpServers": {
    "focusflow": {
      "url": "https://flow.milg.ca/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Restart Claude. You should see the FocusFlow tools listed in the MCP panel.

Step 3 — Connect ChatGPT (custom connectors)

In ChatGPT, open Settings → Connectors → Add custom connector. Paste the same FocusFlow MCP URL, choose Bearer auth, and paste your token. ChatGPT will discover the tool schema automatically.

Step 4 — Connect Cursor, Zed, or Windsurf

These editors read the same mcpServers block Claude Desktop uses. Add the entry from Step 2 to your editor's MCP settings file and reload the window.

Step 5 — Try it

  • "Add 'draft Q3 memo' to focus, due Friday"create_task
  • "What's available right now?"list_available
  • "Mark the design review reply done"complete_task

Where to go next

Explore the Pro plan to enable multi-agent access and shared workspaces, or read the upstream MCP spec to build your own tools on top of FocusFlow.