Amazing Marvin (complete) MCP server

Read from the package source without running it. The installed server may list more.

• claim_reward_points

  Award reward points for a completed task or manually. Note: mark_done does not award a task's rewardPoints automatically through the API (cf. issue #6 about kudos) — call this tool separately afterwards. WARNING: a MANUAL award CANNOT be undone through the API (verified live 2026-08-19: unclaim returns 404, negative points are rejected with 400). The only compensation is spend_reward_points for th

• convert_category_or_project

  Convert a project to a category or back, in place and losslessly. EXPERIMENTAL: Convert project→category or category→project IN PLACE via /doc/update (Full Access Token; there is no official conversion endpoint, and this relies on undocumented server behavior that Marvin could change). Same _id, createdAt and children remain — conversion is a pure type change (verified against the live API 2026-08

• create_category_or_projectwrite action
• create_eventwrite action

  Create a calendar event (experimental), synced by the app. EXPERIMENTAL: Create a calendar event. Calendar sync happens in the client — the Marvin app must be running on some device for the event to sync onwards to an external calendar.

• create_taskwrite action
• create_time_blockwrite action

  Create a time block (experimental) and get its id back. EXPERIMENTAL: Create a time block via /doc/create (db='PlannerItems', Full Access Token). No official endpoint exists. Verify in the app that the block looks right.

• delete_reminderwrite action

  Delete one or more server-side reminders. Note: for a reminder that belongs to a task (set in the app), only the server-side entry is removed — the task document's reminder fields are not cleared, so the app may show it as active and recreate it. Prefer using this against standalone reminders (type 'M') or to clean up orphaned entries from get_reminders.

• delete_taskwrite action

  Delete a task permanently, with no trash and no undo. Delete a task/document PERMANENTLY via /doc/delete (Full Access Token). Marvin's trash is client-side — an API deletion bypasses it and CANNOT be undone (deleting in the app instead puts the item in the trash, where it can be restored — prefer the app when undo matters). Only use when the user explicitly wants a deletion. Never delete the gener

• get_account_info

  Get account info (/me): email, tracking status and points balance.

• get_categories

  Get all categories and projects as a hierarchy with id and parentId. Get all categories and projects (the whole hierarchy; parentId='root' is the top level). Use to find the right parent_id when creating/moving.

• get_children

  Get open tasks and subprojects in a category or project. Returns direct children only — call again for deeper levels. Note: orphans (tasks whose parentId points to a deleted/non-existent document) do NOT show up under 'unassigned' — only in get_today_items/get_due_items if they have a day/dueDate (live-tested 2026-08-29). Orphans are repaired by running FIX_CYCLES() in the app's console (a documen

• get_done_items

  Get tasks completed on a given date. Tasks completed on a given date (doneAt within that day, configured timezone) — regardless of priority and deadline. Built on the UNDOCUMENTED endpoint GET /doneItems?date= (missing from the OpenAPI spec and the wiki; live-tested 2026-08-30, may disappear): it filters on the task's `day`, not on doneAt. A past `day` is kept on completion both in the app and via

• get_due_items

  Get open tasks and projects with a deadline today or earlier.

• get_goals

  Get all goals with status and check-in data.

• get_habit

  Get a habit's server tracking record with its full history. Get the server's tracking record for a single habit (habitId + full history — the source of truth for recordings). Note: the response lacks title and settings; those are in list_habits.

• get_kudos

  Get kudos, level and kudosRemaining from Marvin's XP system. Note: kudos is separate from reward points (the reward currency) — the point balance is in get_account_info. nextMultiplier only exists in /me, not here (known limitation, MarvinAPI issue #5).

• get_labels

  Get all labels with ids, for label_ids and filtering.

• get_rate_limit_status

  Show today's Marvin API calls against the 1440/day budget. Show how many Marvin API calls have been made today (budget 1440/day, shared by all tools).

• get_reminders

  Get all server-side reminders, push notifications to the phone. Requires the Full Access Token.

• get_time_tracks

  Get time-tracking history for up to 100 tasks. Get time-tracking history for the given tasks (the source of truth, max 100 per call).

• get_today_items

  Get open tasks and projects scheduled today or earlier. Get open tasks/projects with `day` <= the date (default today in MARVIN_TIMEZONE, or the system's local timezone when unset) — i.e. also items scheduled earlier than the date, not only those on exactly that day. Tasks that only have a deadline are not included; fetch them with get_due_items. Observed 2026-09-11 with rollover enabled in the ac

• get_today_time_blocks

  Get today's time blocks with their category or smart-list mapping. The API response lacks the category link (known limitation, MarvinAPI issue #65); the mapping is therefore fetched separately from the profile setting plannerSmartLists (key = normalized block title).

• get_tracked_item

  Show which task is being time-tracked right now.

• list_capabilities

  List every Marvin tool by area, with what it can and cannot do. Costs no Marvin API call. Call it before assuming something is impossible via MCP or requires manual work in the app; field conditions and live-tested details live in each tool's own description.

• list_habits

  Get all habits with title, settings and history. Get all habits as full documents incl. title, settings and history ([time1, value1, time2, value2, ...], unix ms). Requires the Full Access Token (the raw variant of /habits). Important (verified live 2026-08-19): non-raw /habits would be wrong here — it reads the server's tracking registry, which is created lazily on the first recording, so never-r

• mark_done

  Mark a task as done; projects are completed in the app. Mark a task as done (via /markDone, with the correct timezone offset). Tasks ONLY: for projects the API responds 400 'Can only mark Tasks done with this API' (verified live 2026-08-19) — projects are completed in the Marvin app (done=true via /doc/update would technically work but skips the app's side effects). Safe for generated instances of

• record_habit

  Record or undo a habit check-in, synced to the app. Also updates the sync database (updateDB=true) so the Marvin app shows the change immediately.

• reset_reward_points

  Reset reward points permanently, balance and history. Reset reward points PERMANENTLY: deletes the whole earn/spend history and sets the balance to 0 (Full Access Token). CANNOT be undone — only use when the user explicitly asks for it.

• set_priority

  Set priority (P1-P3 or low) or the frog marker on a task. Set or change priority (isStarred) and/or the frog marker on an existing TASK. Requires the Full Access Token. The app's four levels are stored as isStarred 3/2/1/-1 (Most/Very/Important/Low priority; -1 verified against the app's code and live-tested 2026-08-30). Low priority is shown in the app only with 'Enable low priority' on in the Pr

• set_reminder

  Set a standalone push reminder to the phone. Times on tasks are set in the app, not here. Set a standalone push reminder (type 'M', requires the Marvin mobile app to be logged in). WARNING — data integrity: a task reminder in Marvin consists of TWO writes that only the app keeps in sync — reminder fields on the task document itself (taskTime, reminderTime, reminderOffset, snooze, autoSnooze) AND a

• spend_reward_points

  Spend reward points on a reward. Note (verified live): the API responds 500 Internal Server Error if the balance would go negative — check the balance (get_account_info) before large purchases.

• start_tracking

  Start time tracking on a task.

• stop_tracking

  Stop time tracking on a task; the time lands in get_time_tracks. Stop time tracking for a task. Note (documented API limitation, confirmed live 2026-09-02): the task's own times/duration fields are not updated by /track STOP — the tracking only lands in /tracks (get_time_tracks). Exception: mark_done during active tracking now writes task.times (see mark_done).

• test_connection

  Check that the API token works against Marvin's API. Returns OK if the apiToken works.

• unclaim_reward_points

  Undo a reward-point award tied to a task. Undo a point award (e.g. after a misclick, or when the task was un-completed with unmark_done). Only works for awards tied to a real task ID: Marvin's server stores no entry for MANUAL awards (verified live 2026-08-19, /unclaimRewardPoints responds 404 'No such entry'). Compensate a MANUAL award with spend_reward_points for the same amount instead.

• unmark_done

  Undo a task's completion. Undo a completion (sets done=false and clears doneAt via /doc/update). Requires the Full Access Token. Safe for generated instances of recurring tasks too (verified live). Note: any kudos from the completion are not adjusted; awarded reward points can however be undone with unclaim_reward_points. A permanent 500 = the document does not exist (deleted or wrong ID; the serv

• update_category_or_projectwrite action
• update_taskwrite action

• Code scan7 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 1 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Amazing Marvin (complete): common questions

Is Amazing Marvin (complete) MCP server safe?

Mostly: it is graded B (83/100). Read the Amazing Marvin (complete) safety report

How do I install Amazing Marvin (complete)?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Amazing Marvin (complete) need an API key?

Yes. The registry entry asks for MARVIN_API_TOKEN, MARVIN_FULL_ACCESS_TOKEN.

Is Amazing Marvin (complete) maintained?

The last commit was 2 days ago (2026-09-18). The latest release is v1.7.2.

What can I use instead of Amazing Marvin (complete)?

Servers from other publishers that do the same job: Agent-Native Calendar MCP server, FlutterSDK Docs MCP server and L2 Calendar MCP server. Compare all Amazing Marvin (complete) alternatives.