Amazing Marvin (complete) — Claude Code MCP server
Connects the Amazing Marvin task manager to your assistant using 50 tools. Handy for scheduling tasks, logging habits, and tracking time via chat.
claude mcp add --env MARVIN_API_TOKEN=<MARVIN_API_TOKEN> --env MARVIN_FULL_ACCESS_TOKEN=<MARVIN_FULL_ACCESS_TOKEN> --env MARVIN_TIMEZONE=<MARVIN_TIMEZONE> --transport stdio amazing-marvin-complete -- uvx amazing-marvin-complete-mcpWhat Amazing Marvin (complete) does
This MCP server exposes 50 tools mapping to 38 public endpoints in Amazing Marvin. It covers creating and completing tasks, recurring items, notebooks, habit logs, and time blocks. The integration intentionally omits attachment downloads and bulk reminder wipes. Decision logic for Smart Lists stays inside Marvin itself.
The server runs on Python 3.12+ through uvx. Authentication uses two distinct secrets from the Marvin API settings page. A standard MARVIN_API_TOKEN permits reading and creating tasks. Modifying items, changing priorities, deleting records, and configuring categories require MARVIN_FULL_ACCESS_TOKEN. Without that second secret, write calls will fail.
What it helps with
- create and mark tasks or projects complete in Amazing Marvin
- start and stop time tracking on active work items
- log habit completions and inspect habit records
- create and update notebook pages or sections
Example prompts for the agent
- Show my tasks scheduled for today in Amazing Marvin.
- Start tracking time on the database migration task.
- Create a new page in my work notebook with meeting notes.
How to install Amazing Marvin (complete)
Platform CLI
claude mcp add --env MARVIN_API_TOKEN=<MARVIN_API_TOKEN> --env MARVIN_FULL_ACCESS_TOKEN=<MARVIN_FULL_ACCESS_TOKEN> --env MARVIN_TIMEZONE=<MARVIN_TIMEZONE> --transport stdio amazing-marvin-complete -- uvx amazing-marvin-complete-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from amazing-marvin-complete-mcp <command>
Platform CLI
codex mcp add amazing-marvin-complete --env MARVIN_API_TOKEN=<MARVIN_API_TOKEN> --env MARVIN_FULL_ACCESS_TOKEN=<MARVIN_FULL_ACCESS_TOKEN> --env MARVIN_TIMEZONE=<MARVIN_TIMEZONE> -- uvx amazing-marvin-complete-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from amazing-marvin-complete-mcp <command>
Config file
{
"mcpServers": {
"amazing-marvin-complete": {
"command": "uvx",
"args": [
"amazing-marvin-complete-mcp"
],
"env": {
"MARVIN_API_TOKEN": "<MARVIN_API_TOKEN>",
"MARVIN_FULL_ACCESS_TOKEN": "<MARVIN_FULL_ACCESS_TOKEN>",
"MARVIN_TIMEZONE": "<MARVIN_TIMEZONE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from amazing-marvin-complete-mcp <command>
Config file
{
"servers": {
"amazing-marvin-complete": {
"type": "stdio",
"command": "uvx",
"args": [
"amazing-marvin-complete-mcp"
],
"env": {
"MARVIN_API_TOKEN": "<MARVIN_API_TOKEN>",
"MARVIN_FULL_ACCESS_TOKEN": "<MARVIN_FULL_ACCESS_TOKEN>",
"MARVIN_TIMEZONE": "<MARVIN_TIMEZONE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from amazing-marvin-complete-mcp <command>
Platform CLI
gemini mcp add -e MARVIN_API_TOKEN=<MARVIN_API_TOKEN> -e MARVIN_FULL_ACCESS_TOKEN=<MARVIN_FULL_ACCESS_TOKEN> -e MARVIN_TIMEZONE=<MARVIN_TIMEZONE> amazing-marvin-complete uvx amazing-marvin-complete-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from amazing-marvin-complete-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Amazing Marvin (complete)
How to install Amazing Marvin (complete) in Claude Code?
Run `claude mcp add amazing-marvin-complete-mcp -e MARVIN_API_TOKEN=<MARVIN_API_TOKEN> -e MARVIN_FULL_ACCESS_TOKEN=<MARVIN_FULL_ACCESS_TOKEN> -- uvx amazing-marvin-complete-mcp`. Copy both secrets from the API section inside Marvin's settings.
What does this MCP server do?
It provides 50 tools covering Amazing Marvin API endpoints. The assistant can view and edit tasks, habits, time blocks, and notebooks using standard MCP calls.
Why does the server require two API tokens?
The default MARVIN_API_TOKEN grants access for reading and basic task creation only. Updating task details, altering priorities, deleting items, and managing categories require MARVIN_FULL_ACCESS_TOKEN.
