Skip to main content

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

Setup Guide: Claude Code​

Mind Your Now uses OAuth 2.1 for secure authentication. Claude Code handles the entire flow automatically — no API keys needed.

Step 1: Add the MCP server​

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

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

Or add it from the command line:

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

Step 2: Restart Claude Code​

Restart Claude Code to pick up the new server configuration.

Step 3: Authenticate​

In Claude Code, run:

/mcp

Select mind-your-now from the list. Claude Code will open your browser to the Mind Your Now login page. Log in with your MYN account, and Claude Code will receive an OAuth token automatically.

tip

If the browser doesn't open automatically, Claude Code will display a URL you can copy and paste manually.

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: Other MCP Clients​

Mind Your Now supports two transport protocols:

ProtocolEndpointBest For
Streamable HTTP/mcpClaude Code, Cursor, most MCP clients
SSE/sseLegacy MCP clients

MCP clients that support OAuth 2.1 can connect using standard discovery:

  • Server URL: https://api.mindyournow.com/mcp
  • Discovery: https://api.mindyournow.com/.well-known/oauth-authorization-server
  • Dynamic client registration: Supported (RFC 7591)
  • PKCE: Required (S256)

The server returns a WWW-Authenticate header on 401 responses pointing to the protected resource metadata, per the MCP OAuth 2.1 specification.

API Key (Scripts & Automation)​

For non-interactive use cases like scripts, CI/CD, or automation, use API key authentication:

  1. Go to app.mindyournow.com Settings → API Keys
  2. Create a new key with AGENT_FULL scope
  3. Pass the key via the X-API-KEY header
{
  "mcpServers": {
    "mind-your-now": {
      "type": "http",
      "url": "https://api.mindyournow.com/mcp",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Local Development​

If you're running the Mind Your Now API locally:

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

Troubleshooting​

Server not showing in /mcp list​

  • Verify ~/.claude/mcp.json is valid JSON
  • Restart Claude Code after editing mcp.json

OAuth flow doesn't open browser​

  • Run /mcp in Claude Code and select the server
  • If the browser doesn't open, copy the displayed URL manually
  • Make sure https://api.mindyournow.com is reachable

"Unauthorized" after authenticating​

  • Your OAuth token may have expired (tokens last 1 hour, auto-refreshed)
  • Run /mcp and select "Clear authentication" then re-authenticate
  • Check that your MYN account is active

Tools not showing up after authentication​

  • Some MCP clients use lazy tool loading — try asking a question first
  • Verify the server is connected: run /mcp and check the status

Questions? Contact support or check the API documentation.