Amazing Marvin MCP Server

MCP server for Amazing Marvin — manage tasks, projects, habits, goals, time tracking, and rewards directly from any MCP-compatible client.

Quick Start

1. Get your API tokens

1. Open Amazing Marvin (desktop or web)
2. Go to Settings (gear icon) → API
3. Copy your API Token and Full Access Token

2. Add to your MCP client

Add this to your MCP configuration file:

{
  "mcpServers": {
    "amazing-marvin": {
      "command": "npx",
      "args": ["-y", "amazing-marvin-mcp-server"],
      "env": {
        "MARVIN_API_TOKEN": "your-api-token",
        "MARVIN_FULL_ACCESS_TOKEN": "your-full-access-token"
      }
    }
  }
}

The Full Access Token is optional — only needed for advanced operations like direct database access.

Where to add the config

| Client | Config file | |--------|------------| | Kiro | ~/.kiro/settings/mcp.json | | VS Code (Copilot) | .vscode/mcp.json | | Cursor | ~/.cursor/mcp.json | | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) | | Windsurf | ~/.codeium/windsurf/mcp_config.json |

Available Tools

Standard Access (API Token)

| Tool | Description | |------|-------------| | test_credentials | Verify API credentials | | get_me | Get account info and reward points | | get_kudos | Get kudos, level, remaining kudos | | add_task | Create a task (supports shortcuts: +today, #Project, @label) | | mark_done | Mark a task as completed | | get_today_items | Get today's scheduled items | | get_due_items | Get overdue items | | get_children | Get children of a category/project | | add_project | Create a new project | | add_event | Create a calendar event | | get_categories | List all categories | | get_labels | List all labels | | get_tracked_item | Get currently tracked task | | track_time | Start/stop time tracking | | get_tracks | Get time data for tasks | | get_today_time_blocks | Get today's time blocks | | get_habits | List all habits | | get_habit | Get a single habit with history | | update_habit | Record/undo/rewrite habit data | | get_goals | List all goals | | claim_reward_points | Claim reward points | | unclaim_reward_points | Undo a reward claim | | spend_reward_points | Spend reward points | | set_reminders | Set reminders (mobile push) | | delete_reminders | Delete specific reminders |

Full Access (Full Access Token)

| Tool | Description | |------|-------------| | get_doc | Read any document by ID | | update_doc | Update any document fields | | create_doc | Create any document | | delete_doc | Permanently delete a document | | get_reminders | Get all scheduled reminders | | delete_all_reminders | Delete ALL reminders | | reset_reward_points | Reset all reward points to 0 |

Rate Limits

The Marvin API enforces strict rate limits:

• Max 1 item creation per second
• Max 1 query burst every 3 seconds
• Max 1440 queries per day

Requirements

• Node.js 18+

License

MIT