---
canonical_url: "https://docs.composio.dev/toolkits/amazing_marvin"
markdown_url: "https://docs.composio.dev/toolkits/amazing_marvin.md"
product: "platform"
version: null
last_updated: null
---

# Amazing Marvin

Amazing Marvin is a customizable personal productivity application for managing tasks, projects, planning, habits, time tracking, and rewards.

- **Category:** productivity
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `AMAZING_MARVIN`
- **Version:** 20261006_00

## Tools

### Complete Task

**Slug:** `AMAZING_MARVIN_COMPLETE_TASK`

Mark one task complete using Amazing Marvin's experimental completion endpoint. Some client-side effects such as stopping time tracking, rewards, Kudos, and worked-on timestamps are not performed, and this toolkit cannot undo the completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | Yes | ID of the task to mark complete. |
| `confirm_completion` | boolean | Yes | Must be true to acknowledge that completion changes task state and cannot be undone through this toolkit. |
| `time_zone_offset_minutes` | number | Yes | Local UTC offset in minutes (local time minus UTC), such as -480 for UTC-08:00 or 60 for UTC+01:00. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project

**Slug:** `AMAZING_MARVIN_CREATE_PROJECT`

Create a project with optional hierarchy, planning, priority, estimate, labels, and notes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | No | Optional project note. |
| `title` | string | Yes | Project title. |
| `due_date` | string | No | Project due date in YYYY-MM-DD format. |
| `priority` | string ("low" | "mid" | "high") | No | Project priority. |
| `label_ids` | array | No | Amazing Marvin label IDs to assign. |
| `parent_id` | string | No | ID of the parent project or category; omit for a root project. |
| `backburner` | boolean | No | Whether to place the project on the backburner. |
| `planned_week` | string | No | Monday date of the planned week in YYYY-MM-DD format. |
| `planned_month` | string | No | Planned month in YYYY-MM format. |
| `scheduled_date` | string | No | Date to schedule the project in YYYY-MM-DD format. |
| `time_estimate_minutes` | number | No | Estimated project duration in minutes; converted to provider milliseconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Task

**Slug:** `AMAZING_MARVIN_CREATE_TASK`

Create a task with optional scheduling, organization, estimate, and note fields; title autocompletion is enabled by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | No | Optional task note. |
| `title` | string | Yes | Task title; may use Amazing Marvin title-autocompletion syntax when auto_complete_title is true. |
| `due_date` | string | No | Task due date in YYYY-MM-DD format. |
| `label_ids` | array | No | Amazing Marvin label IDs to assign to the task. |
| `parent_id` | string | No | ID of the parent project or category; omit to create an unassigned inbox task. |
| `backburner` | boolean | No | Whether to place the task on the backburner. |
| `planned_week` | string | No | Monday date of the planned week in YYYY-MM-DD format. |
| `bonus_section` | string ("Essential" | "Bonus") | No | Whether the task belongs in the Essential or Bonus section. |
| `daily_section` | string ("Morning" | "Afternoon" | "Evening") | No | Daily planning section for the task. |
| `planned_month` | string | No | Planned month in YYYY-MM format. |
| `scheduled_date` | string | No | Date to schedule the task in YYYY-MM-DD format. |
| `auto_complete_title` | string ("true" | "false") | No | Enable Amazing Marvin title autocompletion; set false to preserve the title literally. Booleans are accepted and sent as the lowercase true/false the provider requires. |
| `time_estimate_minutes` | number | No | Estimated task duration in minutes; converted to provider milliseconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Reminders

**Slug:** `AMAZING_MARVIN_DELETE_REMINDERS`

Permanently delete only the specified Amazing Marvin reminders by exact ID. This does not clear reminder metadata on corresponding tasks and does not provide a delete-all mode.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reminder_ids` | array | Yes | Exact reminder IDs to delete. Use LIST_REMINDERS to resolve IDs; between 1 and 20 distinct IDs are allowed. |
| `confirm_delete` | boolean | Yes | Must be true to confirm permanent deletion of the specified reminders. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Time Tracking

**Slug:** `AMAZING_MARVIN_GET_CURRENT_TIME_TRACKING`

Return the task currently being time-tracked, or tracked=false when no timer is active.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Categories or Labels

**Slug:** `AMAZING_MARVIN_LIST_CATEGORIES_OR_LABELS`

List categories or labels so their IDs can be used when creating and organizing Amazing Marvin tasks and projects.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reference_type` | string ("categories" | "labels") | Yes | Type of organization reference to list: categories or labels. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Planning Items

**Slug:** `AMAZING_MARVIN_LIST_PLANNING_ITEMS`

List open child items, items scheduled for a date, or items due by a date; choose one view per call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format for view='scheduled' or view='due'. It is an exact schedule date for scheduled items and an inclusive upper bound for due items. Supplying it avoids UTC server-date ambiguity. |
| `view` | string ("children" | "scheduled" | "due") | Yes | Collection to return: direct open children, items scheduled for one date, or open items due on or before one date. |
| `parent_id` | string | No | Parent project or category ID for view='children'. Omit it to list open unassigned inbox items. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reminders

**Slug:** `AMAZING_MARVIN_LIST_REMINDERS`

List all currently scheduled Amazing Marvin reminders.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Reminders

**Slug:** `AMAZING_MARVIN_SET_REMINDERS`

Create or replace one or more mobile push reminders using caller-supplied reminder IDs. The Amazing Marvin mobile app must be installed and logged in; this does not update reminder metadata on corresponding tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reminders` | array | Yes | Reminders to create or replace (1-20); keep batches small because provider calls share a strict rate budget. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Time Tracking

**Slug:** `AMAZING_MARVIN_SET_TIME_TRACKING`

Start or stop time tracking for one task. This changes timer state but does not update the stopped task's stored duration or times; inspect issues in the response for provider-reported problems.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action` | string ("START" | "STOP") | Yes | Whether to start or stop tracking the task. |
| `task_id` | string | Yes | ID of the task whose timer should be started or stopped. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Document

**Slug:** `AMAZING_MARVIN_UPDATE_DOCUMENT`

Update one or more low-level fields on an existing Amazing Marvin document and return the complete persisted document. This highly privileged operation can corrupt documents and break the Marvin client when a key or value has an invalid shape; update only known fields with their expected JSON types.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `setters` | array | Yes | Non-empty ordered field replacements. This low-level operation uses the full-access token; invalid keys or values can corrupt a document and break the Marvin client. |
| `document_id` | string | Yes | ID of the existing Amazing Marvin document to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |