# Amazing Marvin (complete)

Connects the Amazing Marvin task manager to your assistant using 50 tools. Handy for scheduling tasks, logging habits, and tracking time via chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: andreasd083
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/andreasd083/amazing-marvin-complete-mcp
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/amazing-marvin-complete

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `MARVIN_API_TOKEN`, `MARVIN_FULL_ACCESS_TOKEN`, `MARVIN_TIMEZONE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
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>

### Codex

**Platform CLI**
```bash
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-mcp
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
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>

## When to use it
- 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
- 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.

## Similar
- [clickup](https://affpapa.org/en/nevibecode/mcp/clickup.md) — MCP server · ★ 53
- [redmine-mcp-server](https://affpapa.org/en/nevibecode/mcp/redmine-mcp-server.md) — MCP server · ★ 85
- [Astravue MCP](https://affpapa.org/en/nevibecode/mcp/astravue-mcp.md) — MCP server · ★ 12
- [toggl-time-tracker](https://affpapa.org/en/nevibecode/plugins/toggl-time-tracker.md) — plugin · ★ 9
- [atimelogger-mcp](https://affpapa.org/en/nevibecode/mcp/atimelogger-mcp.md) — MCP server · ★ 19
- [todo](https://affpapa.org/en/nevibecode/commands/todo.md) — command · 2723 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md