Amazing Marvin (complete) MCP server

amazing-marvin-complete-mcp

<!-- mcp-name: io.github.andreasd083/amazing-marvin-complete-mcp -->

An MCP (Model Context Protocol) server for Amazing Marvin with complete coverage of the public API: 38 tools over all ~31 documented endpoints (plus the undocumented /doneItems), a global rate limiter that respects Marvin's documented limits, least-privilege token routing, and MCP tool annotations. As of 1.1.0 every writable field in Marvin's official data model (Tasks and Categories/Projects) is either supported by a tool or explicitly documented as unsupported — see docs/field-reconciliation.md. Every non-obvious behavior claim in the tool descriptions was verified against the live API — the findings are documented below in Marvin API quirks & findings, which may be useful even if you never run this server.

Maintenance status: Bug reports are welcome and appreciated — they

help keep this working for everyone. Please note this is a side project

maintained when time allows: bug reports get looked at, but response

times vary and feature requests are unlikely to be picked up. For

installation help, paste this README into your AI assistant — it can walk

you through setup and troubleshooting far faster than I can. Provided

as-is, without guarantees — it's MIT, fork freely.

Tools (38)

Capability overview

listcapabilities (no Marvin API call) returns the same map as the table below, per tool with can and cannot, plus the list of things that only work in the app. Call it before assuming something is impossible via MCP. The server also sends a short instructions text at initialize (shown by Claude Code, not by the claude.ai clients). The first line of every tool description is a whole sentence of at most 75 characters stating the capability — the clients show only that line in their catalog; the test tests/testdiscoverability.py guards it.

Shortened. The full README is on GitHub.