Skip to main content

Connect an AI assistant (MCP)

You can connect AI assistants such as Claude Code, Claude Desktop and other MCP clients to your Mind Your Now account. The assistant can then read and change your tasks, timers, memories and Compass reports when you ask it to.

The same steps are in the web app: go to Settings → Integrations and click Connect MCP API.

What the assistant can do​

The Mind Your Now MCP server offers about 45 tools:

  • Tasks: create, update and delete tasks; list today's tasks; find tasks by zone, date or category; share tasks with household members and answer shares.
  • Compass reports: write and read a report, and apply or undo its suggested changes.
  • Timers and reminders: countdowns, alarms and task reminders; list, cancel and snooze them.
  • Memory: store, search, update and delete Kaia's memories, and search past conversations.
  • Comments: add, edit and delete task comments.
  • Account: your account details.
  • Suggestions: habits at risk of breaking their streak, and reminders worth setting.

Writing a Compass report uses Kaia, so it works only after you allow AI data sharing in Settings → Kaia AI.

Claude Code​

  1. Run this in your terminal:

    claude mcp add --transport http mind-your-now https://api.mindyournow.com/mcp

  2. In Claude Code, run /mcp and choose mind-your-now. A browser window opens; sign in with your Mind Your Now account. If the browser doesn't open, copy the link Claude Code shows.

  3. Ask something like "What tasks do I have today?"

Claude Desktop​

Claude Desktop connects through the mcp-remote package, which needs Node.js on your computer.

  1. In Claude Desktop, go to Settings → Developer → Edit Config.

  2. Add this and save:

    {
      "mcpServers": {
        "mind-your-now": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://api.mindyournow.com/mcp"]
        }
      }
    }

  3. Close and reopen Claude Desktop. The first time it uses a Mind Your Now tool, it asks you to sign in through your browser.

Other MCP clients​

Point the client at https://api.mindyournow.com/mcp (Streamable HTTP). The server supports standard OAuth 2.1 sign-in:

  • Discovery: https://api.mindyournow.com/.well-known/oauth-authorization-server
  • Dynamic client registration is supported.
  • PKCE with S256 is required.

If your client can't do OAuth, use an API key instead:

  1. Go to Settings → API Keys and click Create API Key.

  2. Enter a Name, check Full Agent Access under Permissions, and click Create API Key.

  3. Copy the key (it's shown only once) and send it in the X-API-KEY header:

    {
      "mcpServers": {
        "mind-your-now": {
          "type": "http",
          "url": "https://api.mindyournow.com/mcp",
          "headers": {
            "X-API-KEY": "YOUR_API_KEY"
          }
        }
      }
    }

Treat the key like a password. Anyone who has it can act on your account.

See and remove connected assistants​

Go to Settings → Integrations. Connected AI Assistants lists every assistant signed in to your account. Use Revoke to remove one, or Revoke All Sessions to remove them all. Revoke API keys in Settings → API Keys.

Troubleshooting​

  • The server doesn't appear in Claude Code. Run the claude mcp add command again, then restart Claude Code.
  • "Unauthorized" after signing in. Run /mcp, clear the server's authentication, and sign in again.
  • No tools after signing in. Some clients load tools on first use. Ask a question, then check /mcp shows the server as connected.

Questions: support@mindyournow.com. For the REST API, see the API documentation.