Amazing Marvin MCP Server

エージェントが操作するAmazing Marvinの受信トレイ、日々の計画、プロジェクト、タイマー。

ホスト型 MCP サーバー

npx add-mcp 'https://cotlet.dev/mcp/v1/amazing-marvin'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Amazing Marvin MCP server: Let your AI agent plan your day in Amazing Marvin.

Amazing Marvin has a public REST API for tasks, projects, time tracking and habits, and no official MCP server (checked 6 Nov 2026). Cotlet adds 13 Amazing Marvin tools that need no API token or developer setup, work inside the ChatGPT and Claude apps and run hosted around the clock, with one account for your other apps too.

Connect your Amazing Marvin Inbox, day plans, projects and timers to your agent or workflow. Use MCP or REST from n8n, Make, Zapier and scripts.

MCP setup REST API guide

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Amazing Marvin. Amazing Marvin is a trademark of its owner. If Amazing Marvin's own integrations cover what you need, use them first.

What can you automate in Amazing Marvin?

  • Sort the Inbox into projects
  • Plan today from due dates
  • Reschedule overdue tasks
  • Turn meeting notes into tasks
  • Start and stop the timer
  • Set up a project from a plan

Does Amazing Marvin have an MCP server or an API?

  • The official API takes a token you copy from Features > API in Marvin. Marvin asks for no more than 1 request every 3 seconds and 1440 a day on average.
  • Marvin sends webhooks to your own URL for 23 events, such as a task added, marked done or a timer started.
  • Zapier lists one Amazing Marvin action, Create Task. n8n has no Amazing Marvin node. Several community MCP servers run the official API from your computer.
What you needMarvin APICommunity MCP serverCotlet
No API token to copyToken from Features > APIToken in its configSign in once
Works in the ChatGPT and Claude appsIf you build itDesktop clientsYes
Runs when your computer is offIf you host itNo, runs on your computerYes, hosted
Create tasks and projectsYesYesYes
Reschedule and edit a taskExperimental endpointDepends on the serverYes
Mark a task doneExperimental endpointDepends on the serverYes
Start and stop the timerYesDepends on the serverYes

Checked 6 Nov 2026. Sources: Amazing Marvin Help: API endpoints, Amazing Marvin Help: API getting started, Amazing Marvin Help: Webhooks, Zapier: Amazing Marvin integrations

How does Cotlet connect to Amazing Marvin?

  1. Sign in to Amazing Marvin. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your Amazing Marvin password, and you can switch your agent off from the console at any time.

Connect Amazing Marvin to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Enable Amazing Marvin for agents. Sign up, log in to Amazing Marvin in its Cloud Browser, then press Enable for agents.
  2. Add the Cotlet address. Add https://cotlet.dev/mcp/v1 as an MCP server or connector in your agent.
  3. Approve the connection. Chat apps ask you to sign in to Cotlet. Editors, n8n and scripts use an API key from the console.

One shared address, https://cotlet.dev/mcp/v1, also carries Amazing Marvin next to your other apps. If you enable Amazing Marvin after connecting, refresh the connector so the new tools show up.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-amazing-marvin \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet-amazing-marvin": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-amazing-marvin]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: amazing_marvin_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: amazing_marvin_write

How to use the Amazing Marvin REST API

Create your Cotlet API key

Sign in to your Amazing Marvin account in its Cotlet Cloud Browser and enable the app for agents. This is a Cotlet key: you do not copy the API token from Marvin's Features page.

Create a Cotlet API key with access to Amazing Marvin and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Make your first Amazing Marvin API request

cURL: list_today_tasks:

curl "https://cotlet.dev/api/v1/amazing-marvin/today-tasks?date=2026-11-06" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read the day's tasks

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "amazing-marvin",
  "tool": "list_today_tasks",
  "result": {
    "date": "2026-11-06",
    "tasks": [
      {
        "task_id": "c3f5e1a4-99d2-4f3e-9c77-4a0b2e83d9f6",
        "title": "Draft the pitch deck",
        "project": "Q4 launch",
        "due_date": "2026-11-10",
        "time_estimate_minutes": 60
      },
      {
        "task_id": "d4a6f2b5-aae3-4a4f-ad88-5b1c3f94eaa7",
        "title": "Review the budget sheet",
        "project": "Finance",
        "due_date": null,
        "time_estimate_minutes": 45
      }
    ]
  }
}

Read result.tasks. The tool has no cursor: it returns the open items Marvin shows for one date, so pass date as YYYY-MM-DD and call once per day you need.

The day list filters by date only, so backburner tasks and tasks blocked by a dependency can appear. Keep task IDs in your workflow so later runs update the same task.

Amazing Marvin workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestCall list_due_tasks each morning and post the overdue items to a chat channel.
Python or Node.jsREST APIRead list_inbox_tasks and write the titles to a sheet for a weekly review.
MakeHTTP > Make a requestSend a new row from a form to create_task with a project ID from list_categories.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

These HTTP workflows do not require a native Cotlet connector or a prebuilt template. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication and errors.

Amazing Marvin API endpoints and MCP tools

Find tasks

Open tasks only. The day list filters by date alone, so backburner and blocked tasks can show up; the due list wants a date every time.

  • List Inbox tasks (list_inbox_tasks, read): Open tasks in your Amazing Marvin Inbox, with day, due date and labels.
  • List tasks for a day (list_today_tasks, read): Open tasks scheduled for a day, with project, due date and time estimate.
  • List tasks due by a date (list_due_tasks, read): Open tasks and projects due on or before a date.
  • List tasks in a project (list_project_tasks, read): Open tasks and sub-projects directly inside one project or category.

Projects and labels

The IDs from these tools go into the task tools as project_id and label_ids.

  • List categories and projects (list_categories, read): Your categories and projects, with the parent each one sits under.
  • List labels (list_labels, read): Your labels, with color and label group.
  • Create project (create_project, write): Add a project under a category or another project.

Create, move and finish tasks

Shortcuts in a title such as +today, #Project and @label work unless you turn them off. Complete works on tasks, not projects.

  • Create task (create_task, write): Add a task to the Inbox or to a project, optionally scheduled for a day.
  • Update task (update_task, write): Change a task's title, project, day, due date, labels, estimate or note.
  • Mark task done (complete_task, write): Mark a task as done.

Timer

Marvin tracks one task at a time, so check the running timer first.

  • Get the running timer (get_running_timer, read): The task whose timer is running now, if any.
  • Start timer (start_timer, write): Start the Marvin timer on a task.
  • Stop timer (stop_timer, write): Stop the Marvin timer on a task and return the tracked time.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/amazing-marvin-api-mcp-server#tools

Who can see my Amazing Marvin session, and how do I revoke it?

  • What we store. Your logged-in Amazing Marvin profile, encrypted with AES-256-GCM, in Finland. Not the password.
  • What your agent gets. The 13 Amazing Marvin tools. Never the cookie.
  • What the session sees. Your Inbox, days, projects, labels and timers.
  • What no tool touches. Billing, password, plan and deleting your account.
  • If Marvin logs you out. Your agent gets a link to sign in again. We never type your password.
  • How to cut access. Disable for agents in one click, or reset the browser in the console.

Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Undo and mistakes

  1. Reads your lists. Inbox, projects and labels, so IDs are real.
  2. Plans the change. Which tasks move, to which project or day.
  3. Writes it. Creates or updates the task in your account.
  4. Reports back. The task ID, project, day and due date it now has.
ActionUndo
Create a task or projectDelete it in Marvin
Update a taskCall update_task again with the old values
Mark a task doneFix it in the Marvin app
Start or stop the timerCall the other timer tool

None of the 13 tools waits for your OK: every write lands in your own Marvin and reaches no one. Scheduled runs need no approval.

A task moved to the wrong day is one update away from being right. Ask the agent to put it back.

MCP call:

{
  "name": "create_task",
  "arguments": {
    "title": "Send the press kit to Lena",
    "project_id": "p_q4launch",
    "day": "2026-11-09",
    "due_date": "2026-11-11",
    "label_ids": [
      "lb_7f2a"
    ],
    "time_estimate_minutes": 20
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/amazing-marvin/tasks \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Send the press kit to Lena","project_id":"p_q4launch","day":"2026-11-09","due_date":"2026-11-11","label_ids":["lb_7f2a"],"time_estimate_minutes":20}'

Tool output:

{
  "task_id": "g8e0d6f9-eec7-4e8d-8cdd-9f5a7dd8cee1",
  "title": "Send the press kit to Lena",
  "project_id": "p_q4launch",
  "day": "2026-11-09",
  "due_date": "2026-11-11",
  "label_ids": [
    "lb_7f2a"
  ],
  "time_estimate_minutes": 20
}

Scripts and cron jobs reach the same tools over REST, with the same key and price. A failed call costs nothing. The tools table lists the REST path of each tool.

How much does the Amazing Marvin MCP server cost?

About $27 a month for one person planning every workday with an agent, 4,660 credits. Your Marvin subscription is billed by Marvin as before.

JobCallsCredits
Plan the day from the Inbox and due dates6 × 221,320
Sort the Inbox into projects and labels, weekly11 × 4440
Turn meeting notes into tasks5 × 8400
Time a task and mark it done5 × 201,000
Cloud Browser, 30 days1,500
Total4,660
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Works on the Marvin Pro trial too

The month is our example: a daily plan on 22 workdays, a weekly Inbox sort, 8 sets of meeting notes and 20 timed tasks. We found no public figure for a typical Marvin account. Marvin Pro costs $96 a year billed annually and has a 14-day trial without a card (amazingmarvin.com/pricing, 6 Nov 2026). Dollars at the $29 pack rate.

Amazing Marvin MCP server on GitHub, Zapier or hosted: which to use

OptionWhat it doesWhere it stops
bgheneti/Amazing-Marvin-MCPPython MCP server, 44 stars, last commit 11 Jun 2026.You copy your Marvin API token into its setup and run it yourself.
andreasd083/amazing-marvin-complete-mcp50 tools over the 38 endpoints of the API page, MIT, 11 stars, last commit 13 Oct 2026.Runs on your computer with your tokens from Settings > API.
tsvikas/amazing-marvin-mcpMIT, 1 star, last commit 25 Oct 2026. Edits need the full-access token.Its README advises a second Marvin account for that token.
ZapierOne Amazing Marvin action, Create Task, also through Zapier MCP.No triggers and no reads: it cannot list your Inbox or your day.

The official API is the right base if you write code and can live with one token and the 1440-a-day budget. A community server suits a desktop client you run yourself. Cotlet fits when you want the same jobs inside the ChatGPT or Claude apps, hosted, with nothing to install.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), working since 2019, founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the Amazing Marvin tools.

Amazing Marvin MCP server: questions

How do I connect Amazing Marvin to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Amazing Marvin once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Amazing Marvin account through Cotlet, in their phone apps too.

What can ChatGPT do in Amazing Marvin?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Amazing Marvin: plan today from your Inbox and due dates; sort the Inbox into projects and labels; turn meeting notes into tasks. You ask in plain words, and anything that reaches other people waits for your OK first.

How do I get access?

Create a free account at https://cotlet.dev, open Amazing Marvin under Integrations in the console and log in to Amazing Marvin in its Cloud Browser. The trial starts when you sign up, no card asked.

Why use Cotlet if Amazing Marvin has an API?

The API works, but you copy a token, call it from your own code and stay inside 1 request per 3 seconds and 1440 requests a day (Marvin Help: API getting started). Cotlet needs no API key: you sign in to Marvin once, and ChatGPT, Claude, Cursor, n8n or a script use it. It is hosted, and one Cotlet account covers your other apps too.

Which Amazing Marvin plan do I need?

Marvin sells one plan, Marvin Pro, with a 14-day free trial and no card, and it lists the web app among its platforms (Amazing Marvin pricing page). Cotlet signs in to the web app, so any account that can use it works.

Can the agent search my tasks by text?

No. The tools list tasks by Inbox, day, due date or project, and your agent filters the result. Marvin's API has no search endpoint either (Marvin Help: API endpoints).

Does Amazing Marvin have webhooks?

Yes. Marvin sends webhooks to your own URL for 23 events, such as a task added, edited or marked done and a timer started, at no more than one per 3 seconds (Marvin Help: Webhooks, checked 6 Nov 2026). Cotlet tools do not receive them. Run your agent on a schedule, or point a Marvin webhook at your own workflow.

Does it use the Amazing Marvin website?

Yes. Cotlet works in the Marvin web app in your own Cloud Browser, so you need no desktop app running.

Is the MCP server different from the REST API?

Only the door is different. Both expose the same 13 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with Amazing Marvin?

No. Cotlet is independent and not affiliated with Amazing Marvin or Amazing GmbH.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.