Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Amazing Marvin

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  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.

  4. 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.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)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • amazingmarvin_categories_listList all categories and projects.Read-only

    List 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-only

    List 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-only

    Test 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-only

    List 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-only

    List 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-only

    Get 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-only

    List 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-only

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