Connect Heardo with MCP

Heardo is an MCP server. Connect ChatGPT, Claude or any app that supports MCP (Model Context Protocol), then ask what's due, plan your week or add tasks by chatting. Changes show up on your iPhone straight away.

MCP server URL
https://web.heardo.app/mcp

Connect an app

ChatGPT, Claude and other apps that support remote MCP servers.

  1. Add Heardo as a custom connector:
    • ChatGPT: Settings → Apps & Connectors → turn on Developer mode, then Create. Choose OAuth.
    • Claude: Settings → Connectors → Add custom connector. Leave the advanced settings empty.
    • Anything else: add a remote MCP server (Streamable HTTP) that signs in with OAuth.
  2. Paste the server URL above.
  3. The app opens a Heardo approval page. Sign in to Heardo if needed, choose what the app may do, and select Connect.

Generate a bearer token

For Claude Code and other tools that accept a bearer header, open Heardo → Settings → MCP and select Generate token. Heardo shows the token and a command with your token filled in, once.

Claude Code

claude mcp add --transport http heardo https://web.heardo.app/mcp --header "Authorization: Bearer YOUR_TOKEN"

Codex

export CAPTURE_MCP_TOKEN=YOUR_TOKEN codex mcp add heardo --url https://web.heardo.app/mcp --bearer-token-env-var CAPTURE_MCP_TOKEN

Gemini CLI

gemini mcp add -s user -t http -H "Authorization: Bearer YOUR_TOKEN" heardo https://web.heardo.app/mcp

JSON (Cursor and other mcpServers files)

{ "mcpServers": { "heardo": { "url": "https://web.heardo.app/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

What an AI app can do

See your tasks, categories, due dates, repeats, priorities, notes, checklists and what you said when you captured a task. With changes allowed, it can also add, edit, complete, reopen and delete tasks and categories, and add words to your Dictionary. Disconnect any app from Settings → MCP in Heardo.

get_overview, list_tasks, get_task, list_recordings, get_recording, list_categories, create_task, create_tasks, update_task, complete_tasks, reopen_tasks, delete_tasks, edit_subtask, create_category, update_category, delete_category, add_to_dictionary

Every tool, with what it takes and what it returns: heardo.app/mcp, or the reference as a PDF.