MCP Server Setup

Connect AI coding assistants like Claude Code, Cursor, Windsurf, and other MCP-compatible tools directly to your Mind Your Now account. Manage tasks, timers, habits, memories, and daily briefings without leaving your IDE.

What Is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. Mind Your Now's MCP server exposes your full productivity system as tools that any MCP client can call.

Available Tools

Once connected, your MCP client has access to 44+ tools across these categories:

Task Management (16 tools)

• Create, update, complete, archive, and delete tasks
• Query tasks by priority, status, date, or category
• Share tasks with household members
• Search across your entire task system

Daily Debrief (5 tools)

• Generate and retrieve your daily AI coaching briefing
• Apply or undo AI-suggested task adjustments
• Check briefing status and complete sessions

Timers & Reminders (6 tools)

• Create countdown timers, alarms, and task-linked reminders
• List, cancel, and snooze active timers

Memory & Recall (7 tools)

• Store and retrieve contextual notes
• Search, update, and delete memories
• Search conversation history

Comments (5 tools)

• Add, edit, and delete task comments
• View comment threads and counts

Customer & Profile (3 tools)

• Access goals, ambitions, and preferences
• Update profile settings

Widgets (3 tools)

• Daily debrief card
• Today's task list
• Habit streak progress

Connection Methods

Mind Your Now's MCP server supports two transport protocols:

Protocol	Endpoint	Best For
Streamable HTTP	/mcp	Claude Code, Cursor, most MCP clients
SSE	/sse	Legacy MCP clients

Authentication Options

Method	Header	Best For
API Key	X-API-KEY: <your_key>	Simple setup, scripts, local dev
OAuth 2.1	Authorization: Bearer <token>	Browser-based flows, production

Setup Guide: Claude Code

Step 1: Get an API Key

1. Open Mind Your Now at app.mindyournow.com
2. Go to Settings → API Keys
3. Click Create New Key
4. Select AGENT_FULL scope
5. Copy the key (starts with myn_) — it's only shown once

Step 2: Add to Claude Code

Add the following to your ~/.claude/mcp.json file:

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

Step 3: Restart Claude Code

Restart Claude Code to pick up the new MCP server configuration. You should see Mind Your Now tools available in Claude Code's tool list.

Step 4: Verify

Ask Claude Code something like:

"What tasks do I have today?"

If everything is working, Claude will call the queryTasks tool and return your current tasks.

Setup Guide: Local Development

If you're running the Mind Your Now API locally, use the local dev URL:

{
  "mcpServers": {
    "mind-your-now": {
      "type": "http",
      "url": "https://api.myn.localhost/mcp",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Setup Guide: Other MCP Clients

Any MCP-compatible client can connect using the streamable HTTP transport:

• Server URL: https://api.mindyournow.com/mcp
• Auth Header: X-API-KEY: <your_key>
• Transport: Streamable HTTP (preferred) or SSE at /sse

For OAuth 2.1 clients, the discovery endpoint is:

https://api.mindyournow.com/.well-known/oauth-protected-resource

API Key Scopes

Scope	Description
AGENT_FULL	Full access to all tools. Recommended for AI assistants.

For granular scopes, see the API documentation.

Troubleshooting

"Unauthorized" errors

• Verify your API key is correct and hasn't been revoked
• Ensure the key has AGENT_FULL scope
• Check that the X-API-KEY header is being sent

Tools not showing up

• Restart your MCP client after configuration changes
• Check that the MYN API server is reachable at the configured URL
• Verify the MCP endpoint responds: curl -H "X-API-KEY: your_key" https://api.mindyournow.com/mcp

OAuth flow issues

• Ensure your OAuth client is registered
• Check the discovery endpoint: https://api.mindyournow.com/.well-known/oauth-authorization-server
• OAuth access tokens expire after 1 hour — clients should use refresh tokens

---

Questions? Contact support or check the API documentation.