Amazing Marvin MCP Server
Boîte de réception, plans quotidiens, projets et minuteurs dans Amazing Marvin, gérés par votre agent.
Serveur MCP hébergé
npx add-mcp 'https://cotlet.dev/mcp/v1/amazing-marvin'S’installe dans Claude Code, Codex, Cursor et plus
Documentation
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.
- Free 7-day trial, no card
- Unofficial, not affiliated with Amazing Marvin
- Page: https://cotlet.dev/integrations/amazing-marvin-api-mcp-server
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 need | Marvin API | Community MCP server | Cotlet |
|---|---|---|---|
| No API token to copy | Token from Features > API | Token in its config | Sign in once |
| Works in the ChatGPT and Claude apps | If you build it | Desktop clients | Yes |
| Runs when your computer is off | If you host it | No, runs on your computer | Yes, hosted |
| Create tasks and projects | Yes | Yes | Yes |
| Reschedule and edit a task | Experimental endpoint | Depends on the server | Yes |
| Mark a task done | Experimental endpoint | Depends on the server | Yes |
| Start and stop the timer | Yes | Depends on the server | Yes |
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?
- Sign in to Amazing Marvin. Use your own account in its Cotlet Cloud Browser.
- Choose MCP or REST. Connect your agent or create a Cotlet API key.
- 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.
- Enable Amazing Marvin for agents. Sign up, log in to Amazing Marvin in its Cloud Browser, then press Enable for agents.
- Add the Cotlet address. Add https://cotlet.dev/mcp/v1 as an MCP server or connector in your agent.
- 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
| Tool | Connect through | Example workflow |
|---|---|---|
| n8n | HTTP Request | Call list_due_tasks each morning and post the overdue items to a chat channel. |
| Python or Node.js | REST API | Read list_inbox_tasks and write the titles to a sheet for a weekly review. |
| Make | HTTP > Make a request | Send 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
- Reads your lists. Inbox, projects and labels, so IDs are real.
- Plans the change. Which tasks move, to which project or day.
- Writes it. Creates or updates the task in your account.
- Reports back. The task ID, project, day and due date it now has.
| Action | Undo |
|---|---|
| Create a task or project | Delete it in Marvin |
| Update a task | Call update_task again with the old values |
| Mark a task done | Fix it in the Marvin app |
| Start or stop the timer | Call 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.
| Job | Calls | Credits |
|---|---|---|
| Plan the day from the Inbox and due dates | 6 × 22 | 1,320 |
| Sort the Inbox into projects and labels, weekly | 11 × 4 | 440 |
| Turn meeting notes into tasks | 5 × 8 | 400 |
| Time a task and mark it done | 5 × 20 | 1,000 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 4,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
| Option | What it does | Where it stops |
|---|---|---|
| bgheneti/Amazing-Marvin-MCP | Python 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-mcp | 50 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-mcp | MIT, 1 star, last commit 25 Oct 2026. Edits need the full-access token. | Its README advises a second Marvin account for that token. |
| Zapier | One 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.
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.