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

ToolWhat it doesAccess

• list_inbox_tasks Open tasks in your Amazing Marvin Inbox, with day, due date and labels. read

  Returns the open tasks that sit in the Inbox, the place where Marvin puts a new task that has no project. Each task has its ID, title, scheduled day, due date, label IDs and time estimate. Completed tasks are not listed. Use update_task to give a task a project or a day.

  MCP callamazing_marvin_read → list_inbox_tasks

  REST endpointGET https://cotlet.dev/api/v1/amazing-marvin/inbox-tasks

  Parameters

  No parameters.

  Example response

  {
    "tasks": [
      {
        "task_id": "a1f3c9e2-77b0-4d1c-9a55-2e8f0c61b7d4",
        "title": "Reply to Dana about the invoice",
        "day": null,
        "due_date": "2026-11-09",
        "label_ids": [
          "lb_7f2a"
        ],
        "time_estimate_minutes": 10
      },
      {
        "task_id": "b2e4d0f3-88c1-4e2d-8b66-3f9a1d72c8e5",
        "title": "Book dentist",
        "day": null,
        "due_date": null,
        "label_ids": [],
        "time_estimate_minutes": null
      }
    ]
  }

• list_today_tasks Open tasks scheduled for a day, with project, due date and time estimate. read

  Returns the open items Marvin shows for the day you pick, today when you omit it. It filters by date only, so backburner tasks and tasks blocked by a dependency can appear too. Completed tasks are not listed. Each task has its ID, title, project, due date and time estimate.

  MCP callamazing_marvin_read → list_today_tasks

  REST endpointGET https://cotlet.dev/api/v1/amazing-marvin/today-tasks

  Parameters

  Parameters: list_today_tasks

  Name	Type	Description
  date string	string	Date as YYYY-MM-DD. Default: today.

  Example response

  {
    "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
      }
    ]
  }

• list_due_tasks Open tasks and projects due on or before a date. read

  Returns every open item whose due date is on or before the date you pass, so overdue tasks come back with today's. Pass a date every time; without one Marvin uses its own server date. Each item has its ID, title, due date, scheduled day and project.

  MCP callamazing_marvin_read → list_due_tasks

  REST endpointGET https://cotlet.dev/api/v1/amazing-marvin/due-tasks

  Parameters

  Parameters: list_due_tasks

  Name	Type	Description
  by string required	string	Date as YYYY-MM-DD. Items due on or before this day are returned.

  Example input

  {
    "by": "by"
  }

  Example response

  {
    "by": "2026-11-07",
    "items": [
      {
        "task_id": "e5b7a3c6-bbf4-4b5a-be99-6c2d4aa5fbb8",
        "title": "Send the signed contract",
        "due_date": "2026-11-04",
        "day": null,
        "project": "Clients"
      },
      {
        "task_id": "f6c8b4d7-cca5-4c6b-8faa-7d3e5bb6acc9",
        "title": "Pay the hosting invoice",
        "due_date": "2026-11-07",
        "day": "2026-11-06",
        "project": "Admin"
      }
    ]
  }

• list_project_tasks Open tasks and sub-projects directly inside one project or category. read

  Returns the direct children of the project or category you pass, open items only. Tasks in sub-projects are not included; call the tool again with the sub-project ID. Each item has its ID, title, type, scheduled day and due date.

  MCP callamazing_marvin_read → list_project_tasks

  REST endpointGET https://cotlet.dev/api/v1/amazing-marvin/project-tasks

  Parameters

  Parameters: list_project_tasks

  Name	Type	Description
  project_id string required	string	Project or category ID from list_categories.

  Example input

  {
    "project_id": "project_8c41d2"
  }

  Example response

  {
    "project_id": "p_q4launch",
    "items": [
      {
        "task_id": "c3f5e1a4-99d2-4f3e-9c77-4a0b2e83d9f6",
        "title": "Draft the pitch deck",
        "type": "task",
        "day": "2026-11-06",
        "due_date": "2026-11-10"
      },
      {
        "task_id": "a7d9c5e8-ddb6-4d7c-9abb-8e4f6cc7bdd0",
        "title": "Press kit",
        "type": "project",
        "day": null,
        "due_date": null
      }
    ]
  }

ToolWhat it doesAccess

• list_categories Your categories and projects, with the parent each one sits under. read

  Returns every category and project in your account with its ID, title, parent ID and color. Use the IDs as project_id or parent_id in the other tools. Marvin nests categories and projects without a fixed depth, so follow parent_id to rebuild the tree.

  MCP callamazing_marvin_read → list_categories

  REST endpointGET https://cotlet.dev/api/v1/amazing-marvin/categories

  Parameters

  No parameters.

  Example response

  {
    "categories": [
      {
        "id": "p_work",
        "title": "Work",
        "parent_id": null,
        "color": "#2f9e8f"
      },
      {
        "id": "p_q4launch",
        "title": "Q4 launch",
        "parent_id": "p_work",
        "color": "#e8a33d"
      },
      {
        "id": "p_admin",
        "title": "Admin",
        "parent_id": null,
        "color": "#6b7280"
      }
    ]
  }

• list_labels Your labels, with color and label group. read

  Returns the labels in your account in the order Marvin sorts them. Each has its ID, title, color and group ID. Use the IDs as label_ids in create_task and update_task.

  MCP callamazing_marvin_read → list_labels

  REST endpointGET https://cotlet.dev/api/v1/amazing-marvin/labels

  Parameters

  No parameters.

  Example response

  {
    "labels": [
      {
        "id": "lb_7f2a",
        "title": "waiting",
        "color": "#e8a33d",
        "group_id": null
      },
      {
        "id": "lb_91c3",
        "title": "deep work",
        "color": "#2f9e8f",
        "group_id": null
      }
    ]
  }

• create_project Add a project under a category or another project. write

  Creates the project and returns its ID, which you pass as project_id to create_task. Without a parent it sits at the top level. The priority is one of high, mid or low. It reaches no one and you can edit or delete it in the app, so it does not ask for confirmation.

  MCP callamazing_marvin_write → create_project

  REST endpointPOST https://cotlet.dev/api/v1/amazing-marvin/projects

  Parameters

  Parameters: create_project

  Name	Type	Description
  title string required	string	Project title.
  parent_id string	string	Category or project ID from list_categories. Default: top level.
  priority enum	enum	high, mid or low.
  due_date string	string	Date as YYYY-MM-DD. The due date.
  note string	string	Note text on the project.

  Example input

  {
    "title": "title"
  }

  Example response

  {
    "project_id": "p_relaunch",
    "title": "Website relaunch",
    "parent_id": "p_work",
    "priority": "mid"
  }

ToolWhat it doesAccess

• create_task Add a task to the Inbox or to a project, optionally scheduled for a day. write

  Creates the task in your account and returns its ID. Without a project it lands in the Inbox. Marvin reads shortcuts in the title, for example "+today", "#Q4 launch", "@waiting" and "~30m", unless you pass the exact title with parse_title set to false. It reaches no one and you can change it with update_task or delete it in the app, so it does not ask for confirmation.

  MCP callamazing_marvin_write → create_task

  REST endpointPOST https://cotlet.dev/api/v1/amazing-marvin/tasks

  Parameters

  Parameters: create_task

  Name	Type	Description
  title string required	string	Task title. Marvin shortcuts like +today, #Project, @label and ~30m work unless parse_title is false.
  project_id string	string	Project or category ID from list_categories. Default: the Inbox.
  day string	string	Date as YYYY-MM-DD. Schedules the task for that day.
  due_date string	string	Date as YYYY-MM-DD. The due date.
  label_ids array	array	Label IDs from list_labels.
  time_estimate_minutes integer	integer	Time estimate in minutes.
  note string	string	Note text on the task.
  starred boolean	boolean	Mark the task as starred. Default: false.
  parse_title boolean	boolean	Read shortcuts in the title. Default: true.

  Example input

  {
    "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
  }

  Example response

  {
    "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
  }

• update_task Change a task's title, project, day, due date, labels, estimate or note. write

  Changes only the fields you pass and returns the task as it is now. Passing day schedules the task for that day; passing an empty day unschedules it. Passing project_id moves it out of the Inbox. It reaches no one and you can change it back with another call, so it does not ask for confirmation.

  MCP callamazing_marvin_write → update_task

  REST endpointPATCH https://cotlet.dev/api/v1/amazing-marvin/tasks/{task_id}

  Parameters

  Parameters: update_task

  Name	Type	Description
  task_id string required	string	Task ID from list_inbox_tasks, list_today_tasks, list_due_tasks or list_project_tasks.
  title string	string	New title.
  project_id string	string	Project or category ID from list_categories.
  day string	string	Date as YYYY-MM-DD. Empty string unschedules the task.
  due_date string	string	Date as YYYY-MM-DD. The due date.
  label_ids array	array	Label IDs from list_labels. Replaces the current labels.
  time_estimate_minutes integer	integer	Time estimate in minutes.
  note string	string	New note text.

  Example input

  {
    "task_id": "task_8c41d2"
  }

  Example response

  {
    "task_id": "a1f3c9e2-77b0-4d1c-9a55-2e8f0c61b7d4",
    "title": "Reply to Dana about the invoice",
    "project_id": "p_admin",
    "day": "2026-11-06",
    "due_date": "2026-11-09",
    "label_ids": [
      "lb_7f2a"
    ],
    "time_estimate_minutes": 10
  }

• complete_task Mark a task as done. write

  Marks the task done and returns its ID and the day it was completed. It works on tasks, not projects. It reaches no one, so it does not ask for confirmation.

  MCP callamazing_marvin_write → complete_task

  REST endpointPOST https://cotlet.dev/api/v1/amazing-marvin/tasks/{task_id}/complete

  Parameters

  Parameters: complete_task

  Name	Type	Description
  task_id string required	string	Task ID from list_inbox_tasks, list_today_tasks, list_due_tasks or list_project_tasks.

  Example input

  {
    "task_id": "task_8c41d2"
  }

  Example response

  {
    "task_id": "c3f5e1a4-99d2-4f3e-9c77-4a0b2e83d9f6",
    "title": "Draft the pitch deck",
    "done": true,
    "done_day": "2026-11-06"
  }

ToolWhat it doesAccess

• get_running_timer The task whose timer is running now, if any. read

  Returns the task Marvin is tracking time on right now, with its ID and title. Returns null when no timer runs. Check it before start_timer so you do not leave two tasks timed.

  MCP callamazing_marvin_read → get_running_timer

  REST endpointGET https://cotlet.dev/api/v1/amazing-marvin/running-timer

  Parameters

  No parameters.

  Example response

  {
    "task": {
      "task_id": "c3f5e1a4-99d2-4f3e-9c77-4a0b2e83d9f6",
      "title": "Draft the pitch deck"
    }
  }

• start_timer Start the Marvin timer on a task. write

  Starts time tracking on the task and returns its ID and the start time. Check get_running_timer first, because Marvin tracks one task at a time. It reaches no one, so it does not ask for confirmation.

  MCP callamazing_marvin_write → start_timer

  REST endpointPOST https://cotlet.dev/api/v1/amazing-marvin/tasks/{task_id}/timer/start

  Parameters

  Parameters: start_timer

  Name	Type	Description
  task_id string required	string	Task ID from list_inbox_tasks, list_today_tasks, list_due_tasks or list_project_tasks.

  Example input

  {
    "task_id": "task_8c41d2"
  }

  Example response

  {
    "task_id": "c3f5e1a4-99d2-4f3e-9c77-4a0b2e83d9f6",
    "title": "Draft the pitch deck",
    "started_at": "2026-11-06T09:02:00Z"
  }

• stop_timer Stop the Marvin timer on a task and return the tracked time. write

  Stops time tracking on the task and returns the time tracked in that session. The task stays open; call complete_task to finish it. It reaches no one, so it does not ask for confirmation.

  MCP callamazing_marvin_write → stop_timer

  REST endpointPOST https://cotlet.dev/api/v1/amazing-marvin/tasks/{task_id}/timer/stop

  Parameters

  Parameters: stop_timer

  Name	Type	Description
  task_id string required	string	Task ID from list_inbox_tasks, list_today_tasks, list_due_tasks or list_project_tasks.

  Example input

  {
    "task_id": "task_8c41d2"
  }

  Example response

  {
    "task_id": "c3f5e1a4-99d2-4f3e-9c77-4a0b2e83d9f6",
    "title": "Draft the pitch deck",
    "stopped_at": "2026-11-06T10:05:00Z",
    "session_minutes": 63
  }