amazing-marvin-complete-mcp

Ein MCP-Server (Model Context Protocol) für Amazing Marvin mit vollständiger Abdeckung der öffentlichen API: 34 Tools über alle ~31 dokumentierten Endpunkte, ein globaler Rate-Limiter, der Marvins dokumentierte Limits respektiert, Least-Privilege-Token-Routing und MCP-Tool-Annotationen. Jede nicht offensichtliche Verhaltensbehauptung in den Tool-Beschreibungen wurde gegen die Live-API verifiziert – die Ergebnisse sind unten unter Marvin-API-Eigenheiten und Erkenntnisse dokumentiert, was auch dann nützlich sein kann, wenn du diesen Server nie ausführst.

Wie besehen bereitgestellt. Dieses Projekt wird nicht aktiv gepflegt und kommt ohne Support. Issues sind bewusst deaktiviert. Forke frei – es ist MIT.

Tools (34)

Bewusst nicht enthalten: Smart-List-/Task-Auswahl-Logik. Marvins eigener Spotlight übernimmt die Auswahl; der Server gibt deinem Assistenten Hände, keine Meinungen.

Jedes Tool trägt MCP-Tool-Annotationen (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), sodass leistungsfähige Clients delete_task und reset_reward_points mit dem gebührenden Respekt behandeln.

Related MCP server: Super-Productivity-MCP

So bekommst du deine Marvin-Tokens

Beide Tokens liegen in Amazing Marvin unter Einstellungen → API (app.amazingmarvin.com/pre?api):

• API-Token (MARVIN_API_TOKEN, erforderlich) – eingeschränkter Zugriff; ausreichend zum Lesen und Erstellen von Aufgaben.

• Full-Access-Token (MARVIN_FULL_ACCESS_TOKEN, optional, aber empfohlen) – erforderlich für alle Tools auf Basis von /doc*: update_task, set_priority, unmark_done, delete_task, Kategorie-Erstellung, Zeitblöcke, list_habits, Erinnerungen, reset_reward_points.

Behandle sie wie Passwörter; siehe SECURITY.md.

Installation & Ausführung

Voraussetzung ist Python 3.12+.

git clone <this repo> && cd amazing-marvin-complete-mcp
python -m venv .venv && .venv/bin/pip install .

Lokal (stdio) – Claude Desktop, Claude Code, jeder MCP-Client

Der Standardtransport ist stdio, der Client startet den Server also selbst:

{
  "mcpServers": {
    "amazing-marvin": {
      "command": "/path/to/.venv/bin/marvin-mcp",
      "env": {
        "MARVIN_API_TOKEN": "…",
        "MARVIN_FULL_ACCESS_TOKEN": "…",
        "MARVIN_TIMEZONE": "Europe/Stockholm"
      }
    }
  }
}

(Für Claude Code: claude mcp add amazing-marvin -e MARVIN_API_TOKEN=… -- /path/to/.venv/bin/marvin-mcp.)

Remote (Streamable HTTP)

MCP_TRANSPORT=http PORT=8787 MCP_AUTH_TOKEN_FILE=/path/to/token \
MARVIN_API_TOKEN_FILE=/path/to/api-token .venv/bin/marvin-mcp

Der MCP-Endpunkt ist /mcp. Die eingebaute Bearer-Prüfung (MCP_AUTH_TOKEN) schützt jeden Pfad, ist aber eine interne Barriere und keine vollständige Auth-Geschichte: Setze einen Reverse-Proxy mit TLS davor und für Claude Custom Connectors einen OAuth-2.1-fähigen MCP-Auth-Proxy. Ein Dockerfile für den HTTP-Modus ist enthalten (läuft als Nicht-Root-Benutzer; mounte ein Volume auf /data, um den Tageszähler des Rate-Limits über Neustarts hinweg zu erhalten).

Konfiguration

Alle Einstellungen erfolgen über Umgebungsvariablen – siehe .env.example für die vollständige, kommentierte Liste. Wichtige Punkte: Jedes Secret unterstützt eine *_FILE-Variante (empfohlen); MARVIN_TIMEZONE sollte mit der Zeitzone übereinstimmen, in der dein Marvin-Konto liegt (standardmäßig die Systemzeitzone, in den meisten Containern UTC).

Rate-Limiting

Marvins dokumentierte Limits – 1 Schreibvorgang/Sekunde, 1 Lesevorgang/3 Sekunden, 1440 Aufrufe/Tag – werden von einer einzigen prozessglobalen Warteschlange erzwungen, die von allen Tools und Sessions gemeinsam genutzt wird, mit Sicherheitsmarge (1.1 s / 3.1 s). Der Tageszähler