[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# 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](https://cotlet.dev/integrations/amazing-marvin-api-mcp-server.md#connect)
[REST API guide](https://cotlet.dev/integrations/amazing-marvin-api-mcp-server.md#rest-api)

- Free 7-day trial, no card
- Unofficial, not affiliated with Amazing Marvin
- Page: https://cotlet.dev/integrations/amazing-marvin-api-mcp-server

## 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](https://help.amazingmarvin.com/amazing-marvin/api-endpoints), [Amazing Marvin Help: API getting started](https://help.amazingmarvin.com/amazing-marvin/api-getting-started), [Amazing Marvin Help: Webhooks](https://help.amazingmarvin.com/amazing-marvin/api-webhooks), [Zapier: Amazing Marvin integrations](https://zapier.com/apps/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

| 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](https://cotlet.dev/integrations/amazing-marvin-api-mcp-server.md#tools) lists operations and inputs. The [REST API guide](https://cotlet.dev/docs/api.md) 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](https://cotlet.dev/security.md)). There is no SOC 2 report or third-party pentest yet.

## What happens when Amazing Marvin changes?

- **12 h** between tests of the Amazing Marvin tools
- **$0** for a call to an Amazing Marvin tool paused for repair

When Marvin moves a button or renames a field, the fix happens on our side and your prompts keep working. [status.cotlet.dev](https://status.cotlet.dev) watches the site, console and API every 3 minutes.

## 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.

| 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](https://github.com/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](https://github.com/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](https://github.com/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](https://zapier.com/apps/amazing-marvin/integrations) | 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 with your first app, 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](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

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](https://cotlet.dev/about.md)

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.