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.
- Tools
- 25
- What they doRead · write · destructive
- 14 · 10 · 114 read10 write1 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Amazing Marvin connection
In AgentKit > Connections, create an Amazing Marvin connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'amazingmarvin'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'amazingmarvin_categories_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "amazingmarvin"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="amazingmarvin_categories_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Amazing Marvin credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolamazingmarvin_categories_listList all categories and projects.Read-onlyList Categories
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.
Inputs
This tool takes no inputs.
amazingmarvin_children_listList the tasks and projects inside a category or project, or the Inbox.Read-onlyList Child Items
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.
Inputs
parent_idstringrequired- ID of the category or project, or unassigned for Inbox items. Example: unassigned.
amazingmarvin_credentials_testCheck that the Amazing Marvin API token works.Read-onlyTest Credentials
Check that the Amazing Marvin API token works. Returns OK. Use this to confirm the connection.
Inputs
This tool takes no inputs.
amazingmarvin_due_items_listList open tasks and projects due on or before a date.Read-onlyList Due Items
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.
Inputs
bystring- Return items due on or before this date (YYYY-MM-DD). Defaults to today. Example: 2026-11-20.
amazingmarvin_goals_listList all goals.Read-onlyList Goals
List all goals. Returns each goal's _id, title, status, sections and settings.
Inputs
This tool takes no inputs.
amazingmarvin_habit_getGet one habit with its full history.Read-onlyGet Habit
Get one habit with its full history. Returns the habit's _id, title, target and history. Get the habit ID from amazingmarvin_habits_list.
Inputs
idstringrequired- Habit ID, from amazingmarvin_habits_list. Example: 1n2ifni0qnf31.
amazingmarvin_habits_listList all habits with their full history.Read-onlyList Habits
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.
Inputs
This tool takes no inputs.
amazingmarvin_kudos_getGet the user's Marvin Kudos.Read-onlyGet Kudos
Get the user's Marvin Kudos. Returns the kudos total, level and kudos remaining to the next level.
Inputs
This tool takes no inputs.
amazingmarvin_labels_listList all labels in their sort order.Read-onlyList Labels
List all labels in their sort order. Returns each label's _id, title and color. Use this to find label IDs for new tasks.
Inputs
This tool takes no inputs.
amazingmarvin_me_getGet the Amazing Marvin account's details.Read-onlyGet Account
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.
Inputs
This tool takes no inputs.
amazingmarvin_time_blocks_listList the time blocks planned for today (or another date).Read-onlyList Time Blocks
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.
Inputs
datestring- Day to list (YYYY-MM-DD). Defaults to today. Example: 2026-11-16.
amazingmarvin_time_tracks_getGet recorded time-tracking data for up to 100 tasks.Read-onlyGet Time Tracking Data
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.
Inputs
task_idsarrayrequired- IDs of the tasks, at most 100. Example: ["3f9a2c1b7d", "7e6d5c4b3a"]
amazingmarvin_today_items_listList the tasks and projects scheduled for today (or another date), including rolled-over and auto-scheduled items.Read-onlyList Today's Items
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.
Inputs
datestring- Day to list (YYYY-MM-DD). Defaults to today. Example: 2026-11-16.
amazingmarvin_tracked_item_getGet the task whose time is being tracked right now.Read-onlyGet Tracked Task
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.
Inputs
This tool takes no inputs.
amazingmarvin_event_createCreate a calendar event in Amazing Marvin.WriteCreate Event
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.
Inputs
lengthintegerrequired- Duration in milliseconds (for example 1800000 for 30 minutes). Example: 1800000.
startstringrequired- Start time, ISO 8601. Example: 2026-11-17T09:00:00.000Z.
titlestringrequired- Event title. Example: Team standup.
notestring- Event note (Markdown). Example: Agenda: blockers.
amazingmarvin_habit_updateRecord a habit, undo the last recording, or rewrite its history.WriteRecord Habit
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.
Inputs
habit_idstringrequired- Habit ID, from amazingmarvin_habits_list. Example: 1n2ifni0qnf31.
historyarray- Replace the whole history: alternating timestamps (ms) and values. Example: [1646092800000, 2, 1678378323530, 4]
timeinteger- When to record it, as a Unix timestamp in milliseconds. Example: 1763300000000.
undoboolean- true undoes the last recording. Example: false.
update_dbboolean- true also updates the habit document the Marvin app reads. Recommended. Example: true.
valuenumber- Value to record (for example 1 for done, or an amount). Example: 1.
amazingmarvin_project_createCreate a project in Amazing Marvin.WriteCreate Project
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.
Inputs
titlestringrequired- 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.
backburnerboolean- Put it in the backburner. Example: false.
bonus_sectionstring- Essential or Bonus. Example: Essential.one of
EssentialBonus custom_sectionstring- ID of a custom section from your strategy settings. Example: a3gnaiN31mz.
daily_sectionstring- Daily section: Morning, Afternoon or Evening. Example: Morning.one of
MorningAfternoonEvening daystring- Day to schedule it on (YYYY-MM-DD). Example: 2026-11-16.
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-20.
is_froggedinteger- Eat-that-frog level: 1 normal, 2 baby, 3 monster. Example: 1.one of
123 label_idsarray- IDs of labels to add, from amazingmarvin_labels_list. Example: ["l1a2b3c4"]
notestring- Note (Markdown). Example: Problems 1-4.
parent_idstring- ID of the parent category or project, from amazingmarvin_categories_list. Omit for the Inbox. Example: d8f2a1b3c4.
planned_monthstring- Month it is planned for (YYYY-MM). Example: 2026-11.
planned_weekstring- Monday of the week it is planned for (YYYY-MM-DD). Example: 2026-11-16.
prioritystring- Project priority: low, mid or high. Example: high.one of
lowmidhigh review_datestring- Date to review it (YYYY-MM-DD). Example: 2026-12-01.
reward_pointsnumber- Reward points earned when it is done. Example: 1.25.
time_block_sectionstring- ID of a time block to put it in, from amazingmarvin_time_blocks_list. Example: b00m3feaMbeaz.
time_estimateinteger- Time estimate in milliseconds (for example 1800000 for 30 minutes). Example: 1800000.
time_zone_offsetinteger- 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.
amazingmarvin_reminders_setCreate or update reminders, pushed to the Amazing Marvin mobile app.WriteSet Reminders
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.
- Idempotent
Inputs
remindersarrayrequired- 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,...
amazingmarvin_reward_points_claimAdd reward points for a completed task or a manual celebration.WriteClaim Reward Points
Add reward points for a completed task or a manual celebration. Returns the updated reward points information. Use amazingmarvin_reward_points_unclaim to undo.
Inputs
datestringrequired- Date of the claim (YYYY-MM-DD). Example: 2026-11-16.
item_idstringrequired- Task ID the points are for, or MANUAL for a manual reward. Example: MANUAL.
pointsnumberrequired- Number of points to add. Example: 2.
amazingmarvin_reward_points_spendSpend reward points, for example on a reward.WriteSpend Reward Points
Spend reward points, for example on a reward. Returns the updated reward points information.
Inputs
datestringrequired- Date of the spend (YYYY-MM-DD). Example: 2026-11-16.
pointsnumberrequired- Number of points to spend. Example: 5.
amazingmarvin_reward_points_unclaimUndo reward points claimed for an item, for example after marking a task incomplete.WriteUnclaim Reward Points
Undo reward points claimed for an item, for example after marking a task incomplete. Returns the updated reward points information.
Inputs
datestringrequired- Date of the original claim (YYYY-MM-DD). Example: 2026-11-16.
item_idstringrequired- Task ID (or MANUAL) whose claim to undo. Example: 3f9a2c1b7d.
amazingmarvin_task_createCreate a task in Amazing Marvin, optionally scheduled, due, in a category or project, with labels and an estimate.WriteCreate Task
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.
Inputs
titlestringrequired- 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_completestring- Set to false to keep the title exactly as written instead of applying Marvin shortcuts. Defaults to true. Example: false.one of
truefalsedefaulttrue backburnerboolean- Put it in the backburner. Example: false.
bonus_sectionstring- Essential or Bonus. Example: Essential.one of
EssentialBonus custom_sectionstring- ID of a custom section from your strategy settings. Example: a3gnaiN31mz.
daily_sectionstring- Daily section: Morning, Afternoon or Evening. Example: Morning.one of
MorningAfternoonEvening daystring- Day to schedule it on (YYYY-MM-DD). Example: 2026-11-16.
due_datestring- Due date (YYYY-MM-DD). Example: 2026-11-20.
is_froggedinteger- Eat-that-frog level: 1 normal, 2 baby, 3 monster. Example: 1.one of
123 is_starredinteger- Priority star: 1 yellow, 2 orange, 3 red. Example: 3.one of
123 label_idsarray- IDs of labels to add, from amazingmarvin_labels_list. Example: ["l1a2b3c4"]
notestring- Note (Markdown). Example: Problems 1-4.
parent_idstring- ID of the parent category or project, from amazingmarvin_categories_list. Omit for the Inbox. Example: d8f2a1b3c4.
planned_monthstring- Month it is planned for (YYYY-MM). Example: 2026-11.
planned_weekstring- Monday of the week it is planned for (YYYY-MM-DD). Example: 2026-11-16.
review_datestring- Date to review it (YYYY-MM-DD). Example: 2026-12-01.
reward_pointsnumber- Reward points earned when it is done. Example: 1.25.
time_block_sectionstring- ID of a time block to put it in, from amazingmarvin_time_blocks_list. Example: b00m3feaMbeaz.
time_estimateinteger- Time estimate in milliseconds (for example 1800000 for 30 minutes). Example: 1800000.
time_zone_offsetinteger- 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.
amazingmarvin_task_mark_doneMark a task as done.WriteMark Task Done
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.
- Idempotent
Inputs
item_idstringrequired- ID of the task to complete. Example: 3f9a2c1b7d.
time_zone_offsetintegerrequired- 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.
amazingmarvin_time_tracking_setStart or stop the time-tracking timer on a task.WriteStart or Stop Time Tracking
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.
Inputs
actionstringrequired- START or STOP. Example: START.one of
STARTSTOP task_idstringrequired- ID of the task. Example: 3f9a2c1b7d.
amazingmarvin_reminders_deleteDelete reminders by ID.DestructiveDelete Reminders
Delete reminders by ID. Returns OK. Also remove the reminder from its task in Marvin to keep the app accurate.
- Idempotent
Inputs
reminder_idsarrayrequired- IDs of the reminders to delete. Example: ["AA64AC0A-42BD-4EC7-A9F9-8E27BDFA3665"]
No tools match.