> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Amazing Marvin

The Amazing Marvin connector lets your AI agent act in each user's Amazing Marvin account. Each user connects their own Amazing Marvin API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 25 tools.

**Authentication:** API Key
**Categories:** Productivity, Project Management
**Tools:** 25: 14 read, 10 write, 1 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=AMAZINGMARVIN)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Amazing Marvin connection

   In **AgentKit > Connections**, create an Amazing Marvin connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'amazingmarvin'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Amazing Marvin:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'amazingmarvin_categories_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "amazingmarvin"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Amazing Marvin:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="amazingmarvin_categories_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Amazing Marvin credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'amazingmarvin_categories_list',
  toolInput: {},
  connector: 'amazingmarvin',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="amazingmarvin_categories_list",
    tool_input={},
    connection_name="amazingmarvin",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `amazingmarvin_categories_list`

List Categories · Read-only

List all categories and projects.
Returns each one's _id, title, type, parentId and settings.
Use this to find a parent_id for new tasks or for amazingmarvin_children_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_children_list`

List Child Items · Read-only

List the tasks and projects inside a category or project, or the Inbox.
Returns each item's _id, title, type, done flag and other fields.
Get category IDs from amazingmarvin_categories_list; use unassigned for the Inbox.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `parent_id` (`string`, required): ID of the category or project, or unassigned for Inbox items. Example: unassigned.

Example input: `{"parent_id":"<parent_id>"}`

### `amazingmarvin_credentials_test`

Test Credentials · Read-only

Check that the Amazing Marvin API token works.
Returns OK.
Use this to confirm the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_due_items_list`

List Due Items · Read-only

List open tasks and projects due on or before a date.
Returns each item's _id, title, dueDate and other task fields.
Use amazingmarvin_today_items_list for what is scheduled today.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `by` (`string`, optional): Return items due on or before this date (YYYY-MM-DD). Defaults to today. Example: 2026-11-20.

Example input: `{}`

### `amazingmarvin_goals_list`

List Goals · Read-only

List all goals.
Returns each goal's _id, title, status, sections and settings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_habit_get`

Get Habit · Read-only

Get one habit with its full history.
Returns the habit's _id, title, target and history.
Get the habit ID from amazingmarvin_habits_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Habit ID, from amazingmarvin_habits_list. Example: 1n2ifni0qnf31.

Example input: `{"id":"<id>"}`

### `amazingmarvin_habits_list`

List Habits · Read-only

List all habits with their full history.
Returns each habit's _id, title, target and recorded history.
Use amazingmarvin_habit_update to record a habit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_kudos_get`

Get Kudos · Read-only

Get the user's Marvin Kudos.
Returns the kudos total, level and kudos remaining to the next level.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_labels_list`

List Labels · Read-only

List all labels in their sort order.
Returns each label's _id, title and color.
Use this to find label IDs for new tasks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_me_get`

Get Account · Read-only

Get the Amazing Marvin account's details.
Returns the user's email, settings and reward points information.
Use this to confirm which account is connected.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_time_blocks_list`

List Time Blocks · Read-only

List the time blocks planned for today (or another date).
Returns each block's _id, title, date, time and duration.
Use a block's ID as time_block_section when creating a task.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date` (`string`, optional): Day to list (YYYY-MM-DD). Defaults to today. Example: 2026-11-16.

Example input: `{}`

### `amazingmarvin_time_tracks_get`

Get Time Tracking Data · Read-only

Get recorded time-tracking data for up to 100 tasks.
Returns each task's tracked time intervals.
Use amazingmarvin_tracked_item_get for the task being tracked now.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `task_ids` (`array`, required): IDs of the tasks, at most 100. Example: ["3f9a2c1b7d", "7e6d5c4b3a"]

Example input: `{"task_ids":["3f9a2c1b7d","7e6d5c4b3a"]}`

### `amazingmarvin_today_items_list`

List Today's Items · Read-only

List the tasks and projects scheduled for today (or another date), including rolled-over and auto-scheduled items.
Returns each item's _id, title, parentId, day, dueDate, done flag and other task fields.
Use this for a day plan. Use amazingmarvin_due_items_list for overdue and due work.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date` (`string`, optional): Day to list (YYYY-MM-DD). Defaults to today. Example: 2026-11-16.

Example input: `{}`

### `amazingmarvin_tracked_item_get`

Get Tracked Task · Read-only

Get the task whose time is being tracked right now.
Returns the task, or nothing when no timer is running.
Use amazingmarvin_time_tracking_set to start or stop tracking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `amazingmarvin_event_create`

Create Event · Write

Create a calendar event in Amazing Marvin. Calendar sync to external calendars happens in the Marvin app.
Returns the created event.
Use amazingmarvin_task_create for to-dos.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `length` (`integer`, required): Duration in milliseconds (for example 1800000 for 30 minutes). Example: 1800000.
- `start` (`string`, required): Start time, ISO 8601. Example: 2026-11-17T09:00:00.000Z.
- `title` (`string`, required): Event title. Example: Team standup.
- `note` (`string`, optional): Event note (Markdown). Example: Agenda: blockers.

Example input: `{"length":1800000,"start":"<start>","title":"<title>"}`

### `amazingmarvin_habit_update`

Record Habit · Write

Record a habit, undo the last recording, or rewrite its history.
Returns the habit's new value.
Set update_db=true so the Marvin app shows the change.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `habit_id` (`string`, required): Habit ID, from amazingmarvin_habits_list. Example: 1n2ifni0qnf31.
- `history` (`array`, optional): Replace the whole history: alternating timestamps (ms) and values. Example: [1646092800000, 2, 1678378323530, 4]
- `time` (`integer`, optional): When to record it, as a Unix timestamp in milliseconds. Example: 1763300000000.
- `undo` (`boolean`, optional): true undoes the last recording. Example: false.
- `update_db` (`boolean`, optional): true also updates the habit document the Marvin app reads. Recommended. Example: true.
- `value` (`number`, optional): Value to record (for example 1 for done, or an amount). Example: 1.

Example input: `{"habit_id":"<habit_id>"}`

### `amazingmarvin_project_create`

Create Project · Write

Create a project in Amazing Marvin.
Returns the created project.
Add tasks to it with amazingmarvin_task_create and parent_id set to the project's ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `title` (`string`, required): Project title. Unless auto_complete is false, Marvin shortcuts in the title are applied and removed: +today or +tomorrow schedules it, #Category sets the parent, @label adds labels, ~30m sets a time estimate. Example: Website relaunch.
- `backburner` (`boolean`, optional): Put it in the backburner. Example: false.
- `bonus_section` (`string`, optional): Essential or Bonus. Example: Essential. One of: `Essential`, `Bonus`.
- `custom_section` (`string`, optional): ID of a custom section from your strategy settings. Example: a3gnaiN31mz.
- `daily_section` (`string`, optional): Daily section: Morning, Afternoon or Evening. Example: Morning. One of: `Morning`, `Afternoon`, `Evening`.
- `day` (`string`, optional): Day to schedule it on (YYYY-MM-DD). Example: 2026-11-16.
- `due_date` (`string`, optional): Due date (YYYY-MM-DD). Example: 2026-11-20.
- `is_frogged` (`integer`, optional): Eat-that-frog level: 1 normal, 2 baby, 3 monster. Example: 1. One of: `1`, `2`, `3`.
- `label_ids` (`array`, optional): IDs of labels to add, from amazingmarvin_labels_list. Example: ["l1a2b3c4"]
- `note` (`string`, optional): Note (Markdown). Example: Problems 1-4.
- `parent_id` (`string`, optional): ID of the parent category or project, from amazingmarvin_categories_list. Omit for the Inbox. Example: d8f2a1b3c4.
- `planned_month` (`string`, optional): Month it is planned for (YYYY-MM). Example: 2026-11.
- `planned_week` (`string`, optional): Monday of the week it is planned for (YYYY-MM-DD). Example: 2026-11-16.
- `priority` (`string`, optional): Project priority: low, mid or high. Example: high. One of: `low`, `mid`, `high`.
- `review_date` (`string`, optional): Date to review it (YYYY-MM-DD). Example: 2026-12-01.
- `reward_points` (`number`, optional): Reward points earned when it is done. Example: 1.25.
- `time_block_section` (`string`, optional): ID of a time block to put it in, from amazingmarvin_time_blocks_list. Example: b00m3feaMbeaz.
- `time_estimate` (`integer`, optional): Time estimate in milliseconds (for example 1800000 for 30 minutes). Example: 1800000.
- `time_zone_offset` (`integer`, optional): Your UTC offset in minutes, so dates are resolved in your time zone (for example -480 for Pacific Standard Time, 60 for Central European Time). Example: -480.

Example input: `{"title":"<title>"}`

### `amazingmarvin_reminders_set`

Set Reminders · Write

Create or update reminders, pushed to the Amazing Marvin mobile app.
Returns OK.
If a reminder belongs to a task, also update the task in Marvin to keep the app accurate.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reminders` (`array`, required): Reminders to set. Each needs reminderId (a unique ID you choose), time (Unix ms), offset (minutes before time), type (M for manual, t for task, and others), title, and optionally snooze (minutes), autoSnooze and canTrack. Example: [{"reminderId": "AA64AC0A-42BD-4EC7-A9F9-8E27BDFA3665", "time": 1763300000000, "offset": 5, "type": "M", "title": "Stretch", "snooze": 9, "autoSnooze": true,...

Example input: `{"reminders":[]}`

### `amazingmarvin_reward_points_claim`

Claim Reward Points · Write

Add reward points for a completed task or a manual celebration.
Returns the updated reward points information.
Use amazingmarvin_reward_points_unclaim to undo.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Date of the claim (YYYY-MM-DD). Example: 2026-11-16.
- `item_id` (`string`, required): Task ID the points are for, or MANUAL for a manual reward. Example: MANUAL.
- `points` (`number`, required): Number of points to add. Example: 2.

Example input: `{"date":"<date>","item_id":"<item_id>","points":2}`

### `amazingmarvin_reward_points_spend`

Spend Reward Points · Write

Spend reward points, for example on a reward.
Returns the updated reward points information.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Date of the spend (YYYY-MM-DD). Example: 2026-11-16.
- `points` (`number`, required): Number of points to spend. Example: 5.

Example input: `{"date":"<date>","points":5}`

### `amazingmarvin_reward_points_unclaim`

Unclaim Reward Points · Write

Undo reward points claimed for an item, for example after marking a task incomplete.
Returns the updated reward points information.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Date of the original claim (YYYY-MM-DD). Example: 2026-11-16.
- `item_id` (`string`, required): Task ID (or MANUAL) whose claim to undo. Example: 3f9a2c1b7d.

Example input: `{"date":"<date>","item_id":"<item_id>"}`

### `amazingmarvin_task_create`

Create Task · Write

Create a task in Amazing Marvin, optionally scheduled, due, in a category or project, with labels and an estimate.
Returns the created task.
Use amazingmarvin_project_create for projects. Title shortcuts like +today and #Category work unless auto_complete is false.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `title` (`string`, required): Task title. Unless auto_complete is false, Marvin shortcuts in the title are applied and removed: +today or +tomorrow schedules it, #Category sets the parent, @label adds labels, ~30m sets a time estimate. Example: Write report +today ~30m.
- `auto_complete` (`string`, optional): Set to false to keep the title exactly as written instead of applying Marvin shortcuts. Defaults to true. Example: false. One of: `true`, `false`. Default: `true`.
- `backburner` (`boolean`, optional): Put it in the backburner. Example: false.
- `bonus_section` (`string`, optional): Essential or Bonus. Example: Essential. One of: `Essential`, `Bonus`.
- `custom_section` (`string`, optional): ID of a custom section from your strategy settings. Example: a3gnaiN31mz.
- `daily_section` (`string`, optional): Daily section: Morning, Afternoon or Evening. Example: Morning. One of: `Morning`, `Afternoon`, `Evening`.
- `day` (`string`, optional): Day to schedule it on (YYYY-MM-DD). Example: 2026-11-16.
- `due_date` (`string`, optional): Due date (YYYY-MM-DD). Example: 2026-11-20.
- `is_frogged` (`integer`, optional): Eat-that-frog level: 1 normal, 2 baby, 3 monster. Example: 1. One of: `1`, `2`, `3`.
- `is_starred` (`integer`, optional): Priority star: 1 yellow, 2 orange, 3 red. Example: 3. One of: `1`, `2`, `3`.
- `label_ids` (`array`, optional): IDs of labels to add, from amazingmarvin_labels_list. Example: ["l1a2b3c4"]
- `note` (`string`, optional): Note (Markdown). Example: Problems 1-4.
- `parent_id` (`string`, optional): ID of the parent category or project, from amazingmarvin_categories_list. Omit for the Inbox. Example: d8f2a1b3c4.
- `planned_month` (`string`, optional): Month it is planned for (YYYY-MM). Example: 2026-11.
- `planned_week` (`string`, optional): Monday of the week it is planned for (YYYY-MM-DD). Example: 2026-11-16.
- `review_date` (`string`, optional): Date to review it (YYYY-MM-DD). Example: 2026-12-01.
- `reward_points` (`number`, optional): Reward points earned when it is done. Example: 1.25.
- `time_block_section` (`string`, optional): ID of a time block to put it in, from amazingmarvin_time_blocks_list. Example: b00m3feaMbeaz.
- `time_estimate` (`integer`, optional): Time estimate in milliseconds (for example 1800000 for 30 minutes). Example: 1800000.
- `time_zone_offset` (`integer`, optional): Your UTC offset in minutes, so dates are resolved in your time zone (for example -480 for Pacific Standard Time, 60 for Central European Time). Example: -480.

Example input: `{"title":"<title>"}`

### `amazingmarvin_task_mark_done`

Mark Task Done · Write

Mark a task as done.
Returns the updated task.
Get the task ID from amazingmarvin_today_items_list, amazingmarvin_due_items_list or amazingmarvin_children_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `item_id` (`string`, required): ID of the task to complete. Example: 3f9a2c1b7d.
- `time_zone_offset` (`integer`, required): Your UTC offset in minutes, so dates are resolved in your time zone (for example -480 for Pacific Standard Time, 60 for Central European Time). Example: -480.

Example input: `{"item_id":"<item_id>","time_zone_offset":-480}`

### `amazingmarvin_time_tracking_set`

Start or Stop Time Tracking · Write

Start or stop the time-tracking timer on a task.
Returns the tracking result.
Only one task is tracked at a time; starting one stops the other.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): START or STOP. Example: START. One of: `START`, `STOP`.
- `task_id` (`string`, required): ID of the task. Example: 3f9a2c1b7d.

Example input: `{"action":"START","task_id":"<task_id>"}`

### `amazingmarvin_reminders_delete`

Delete Reminders · Destructive

Delete reminders by ID.
Returns OK.
Also remove the reminder from its task in Marvin to keep the app accurate.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `reminder_ids` (`array`, required): IDs of the reminders to delete. Example: ["AA64AC0A-42BD-4EC7-A9F9-8E27BDFA3665"]

Example input: `{"reminder_ids":["AA64AC0A-42BD-4EC7-A9F9-8E27BDFA3665"]}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
