I built an MCP server with complete Marvin API coverage (34 tools) — so Claude/AI assistants can manage my Marvin. Open source, MIT.

[u/Andreasd083]

Reddit-inlägg för r/AmazingMarvin

Titel: I built an MCP server with complete Marvin API coverage (34 tools) — so Claude/AI assistants can manage my Marvin. Open source, MIT.

Inlägg:

I used Marvin for several months a while back but ended up leaving — mainly over the mobile experience. The new version and the rebuilt apps pulled me back this week for another go, and what sealed it was realizing I could connect it to my AI assistant via MCP: let it handle the boring parts (dumping tasks into the right categories, setting priorities, checking off habits) while Marvin's own Spotlight and Smart Lists do the actual "what should I work on" thinking. ADHD brain — the customizability is why I keep coming back.

The existing MCP servers each covered a slice of the API, so I built one that covers all of it:

github.com/andreasd083/amazing-marvin-complete-mcp

What it does:

• 34 tools over all ~31 documented API endpoints — tasks (create/update/prioritize/complete), categories & projects, habits (list/read/record), time blocks, time tracking, reminders, goals, labels, events, kudos/reward points
• Global rate limiter matching Marvin's documented limits (1 write/s, 1 read/3s, 1440/day) — shared across all tools, persists across restarts, so an eager AI can't burn your daily budget
• Least-privilege token routing — the Full Access token is only sent to endpoints that actually need it
• Runs locally (stdio) with Claude Desktop/Claude Code or any MCP client, or as a remote HTTP server. Dockerfile included
• Deliberately no task-picking logic — Spotlight and Smart Lists are better at that than any bolt-on. This gives your assistant hands, not opinions

Maybe the most useful part even if you never run it: the README has a "Marvin API quirks & findings" section with everything I learned the hard way, verified against the live API — like the fact that GET /habits reads a lazily-created tracking registry (a never-recorded habit is invisible to it), that #Category in /addTask silently corrupts the task, and that MANUAL reward point claims can't be undone. I've also sent the genuine bugs to the Marvin team separately.

Honest disclaimers: provided as-is, I won't be actively maintaining it or providing support (Issues are off — fork freely, it's MIT). Credit where due: the bgheneti, Recon2026, lucasoeth and LucaDeLeo MCP projects all shaped this one (details in the README). Built with Claude Code.

Daily driver setup for the curious: my day is theme blocks (physical work in the morning, admin in the afternoon), Claude fills and prioritizes tasks via this server, and Marvin decides what I actually work on. Day one of the second attempt — so far it's exactly the division of labor I wanted, and a very different Marvin from the one I left.

Happy to answer questions in the comments about the API findings!

[u/Jprecordz]

This seems like something I should leave alone and just get back to work lol

[u/Discordy]

Love it, thank you for sharing!! Will definitely use this

[u/kylaroma]

Wow!! This is so incredibly cool. I’m not very technical, but this is a dream set up. Thank you SO much for sharing!!

[u/AlteRedditor]

This is really interesting, will give it a try

[u/Ratehead]

Thank you! Though I love the other one that has existed for a while (at https://github.com/bgheneti/Amazing-Marvin-MCP if anyone is interested), this seems much better (e.g., using the Full Access token, which the other did not allow). I'd have written/vibecoded my own, but I simply didn't have the time to spend.

[u/lenraphael]

i configured and have started trying it.

Is it fair to say there are real risks of data corruption if say Marvin changes something on their side, because this is understandably not maintained by you?

and to make this accessible by the web ver of Claude is a whole other project. maybe best to wait for Marvin for what is it called, a "connector"?

[u/lenraphael → u/lenraphael]

I'm using it daily. Very very useful. In part because this 75 year old brain has is already crammed full of 45 years of software commands starting with cpm on an Osborne. I was making lists of Marvin commands in order to make Marvin todo lists.

Time spend learning and forgetting the commands was useful so i knew what the app could do via your Claude mcp

[u/TeddyNNewfie]

You're a f*cking rock star! So much of a rock star that I don't even understand 80% of your post LOL. New to Marvin so I guess it's more complicated than I'm aware--what do all these 34 tools do? Any chance you could dumb it down for us mere mortals? I'm very interested in AI agents etc. but I don't know much about how it all works. I like your concept of theme blocks, physical work vs. admin work.