{
  "name": "TellDone",
  "updated": "2026-10-05",
  "docs": "https://docs.telldone.app/integrations/mcp-access",
  "transport": "Streamable HTTP (stateless, JSON responses). Send Accept: application/json.",
  "servers": {
    "oauth": {
      "url": "https://api.telldone.app/mcp/user",
      "use": "OAuth 2.1 clients (claude.ai connector, Claude Desktop, Claude Code browser sign-in)"
    },
    "bearer": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "use": "Clients configured with a personal access token in a header"
    }
  },
  "plans": {
    "free": "no MCP access",
    "basic": "no MCP access",
    "pro": "read + write (27 tools); can switch to read-only",
    "ultra": "read + write (27 tools); higher plan quotas; can switch to read-only"
  },
  "enable": "In the TellDone app: Settings > Integrations > AI Agents (iPhone) or Settings > AI Agents (web, app.telldone.app). Tap Enable.",
  "auth": {
    "oauth": {
      "spec": "OAuth 2.1, PKCE S256, public clients (no client secret), dynamic client registration",
      "protected_resource_metadata": "https://api.telldone.app/.well-known/oauth-protected-resource",
      "authorization_server_metadata": "https://api.telldone.app/.well-known/oauth-authorization-server",
      "authorization_endpoint": "https://api.telldone.app/oauth/authorize",
      "token_endpoint": "https://api.telldone.app/oauth/token",
      "registration_endpoint": "https://api.telldone.app/oauth/register",
      "revocation_endpoint": "https://api.telldone.app/oauth/revoke",
      "userinfo_endpoint": "https://api.telldone.app/oauth/userinfo",
      "scopes": [
        "notes:read",
        "notes:write",
        "tasks:read",
        "tasks:write",
        "events:read",
        "events:write",
        "reports:read",
        "tags:read",
        "tags:write",
        "profile:read",
        "offline_access"
      ],
      "unauthenticated_response": "401 with WWW-Authenticate: Bearer resource_metadata=\"https://api.telldone.app/.well-known/oauth-protected-resource\"",
      "consent_signin": "Sign in with Apple, Sign in with Google, or TellDone account email and password."
    },
    "bearer": {
      "header": "Authorization: Bearer YOUR_TOKEN",
      "alternative_header": "X-MCP-Token: YOUR_TOKEN",
      "token_source": "Settings > AI Agents > copy token. Regenerate or disable there at any time."
    }
  },
  "rate_limit": "5 requests per second; excess requests get HTTP 429",
  "clients": {
    "claude_ai": {
      "auth": "oauth",
      "steps": "Add a custom connector, enter https://api.telldone.app/mcp/user, sign in with TellDone, click Allow."
    },
    "claude_code_oauth": {
      "command": "claude mcp add --transport http telldone https://api.telldone.app/mcp/user",
      "then": "Run /mcp inside Claude Code and choose Authenticate."
    },
    "claude_code_bearer": {
      "command": "claude mcp add telldone --transport http https://api.telldone.app/mcp/user/mcp --header \"Authorization: Bearer YOUR_TOKEN\""
    },
    "cursor": {
      "file": ".cursor/mcp.json",
      "config": {
        "mcpServers": {
          "telldone": {
            "url": "https://api.telldone.app/mcp/user/mcp",
            "headers": {
              "Authorization": "Bearer YOUR_TOKEN"
            }
          }
        }
      }
    },
    "windsurf": {
      "file": ".codeium/windsurf/mcp_config.json",
      "config": {
        "mcpServers": {
          "telldone": {
            "serverUrl": "https://api.telldone.app/mcp/user/mcp",
            "headers": {
              "Authorization": "Bearer YOUR_TOKEN"
            }
          }
        }
      }
    },
    "codex": {
      "file": "codex.json (as given in TellDone docs)",
      "config": {
        "mcpServers": {
          "telldone": {
            "type": "http",
            "url": "https://api.telldone.app/mcp/user/mcp",
            "headers": {
              "Authorization": "Bearer YOUR_TOKEN"
            }
          }
        }
      }
    },
    "openclaw": {
      "steps": "Settings > MCP Servers > Add",
      "fields": {
        "Name": "TellDone",
        "URL": "https://api.telldone.app/mcp/user/mcp",
        "Auth": "Bearer YOUR_TOKEN"
      }
    },
    "generic": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "header": "Authorization: Bearer YOUR_TOKEN"
    },
    "other_oauth_client": {
      "auth": "oauth",
      "steps": "Any MCP client that supports remote servers with OAuth 2.1 and dynamic client registration can connect: give it https://api.telldone.app/mcp/user and complete the TellDone sign-in. Per-client menu steps are not documented by TellDone."
    }
  },
  "test": "curl -X POST https://api.telldone.app/mcp/user/mcp -H \"Authorization: Bearer YOUR_TOKEN\" -H \"Content-Type: application/json\" -H \"Accept: application/json\" -d '{\"jsonrpc\":\"2.0\",\"method\":\"tools/list\",\"id\":1}'",
  "tools": "https://telldone.ai/mcp/tools.json",
  "support": "support@telldone.app",
  "dynamic_client_registration": "Supported (RFC 7591). Clients register themselves, so no pre-approval is needed."
}