Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Nozbe

Scalekit connector
Open markdown

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

Tools
57
What they doRead · write · destructive
26 · 20 · 1126 read20 write11 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 Nozbe connection

    In AgentKit > Connections, create a Nozbe 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 = 'nozbe'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Nozbe:', 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: 'nozbe_comments_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Nozbe 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
  • nozbe_comment_attachments_listList the file attachments of a comment.Read-only

    List Comment Attachments

    List the file attachments of a comment. Returns attachment metadata (ID, name, size, type). Get comment IDs from nozbe_comments_list.

    Inputs

    comment_idstringrequired
    Comment ID. Example: Xf3kP9qL2mN8vB4w.
  • nozbe_comment_getGet one comment by its 16-character ID.Read-only

    Get Comment

    Get one comment by its 16-character ID. Returns the comment object. Get IDs from nozbe_comments_list.

    Inputs

    comment_idstringrequired
    16-character ID of the comment. Example: Xf3kP9qL2mN8vB4w.
    fieldsstring
    Comma-separated list of fields to return for each object, for example id,name. Leave empty for all fields. Example: id,name,ended_at.
  • nozbe_comments_listList the comments the API token can access, optionally for one task.Read-only

    List Comments

    List the comments the API token can access, optionally for one task. Returns an array of comment objects; page with limit and offset and trim fields with fields. Use nozbe_comment_get for one comment by ID.

    Inputs

    fieldsstring
    Comma-separated list of fields to return for each object, for example id,name. Leave empty for all fields. Example: id,name,ended_at.
    limitinteger
    Maximum number of objects to return (1-10000). Defaults to 100. Example: 100.
    offsetinteger
    Number of objects to skip, for paging. Defaults to 0. Example: 0.
    sort_bystring
    Comma-separated fields to sort by; prefix a field with - for descending order, for example -created_at,name. Example: -created_at,name.
    task_idstring
    16-character ID of the task. Get it from nozbe_tasks_list. Example: Xf3kP9qL2mN8vB4w.
  • nozbe_group_assignments_listList the group assignments the API token can access (which project is in which group), optionally for one group.Read-only

    List Group Assignments

    List the group assignments the API token can access (which project is in which group), optionally for one group. Returns an array of group assignment objects; page with limit and offset and trim fields with fields. Use nozbe_group_assignment_get for one group assignment by ID.

    Inputs

    fieldsstring
    Comma-separated list of fields to return for each object, for example id,name. Leave empty for all fields. Example: id,name,ended_at.
    group_idstring
    16-character ID of the project group. Get it from nozbe_project_groups_list. Example: Xf3kP9qL2mN8vB4w.
    group_typestring
    What the group holds: project or member. Example: project.one of projectmember
    limitinteger
    Maximum number of objects to return (1-10000). Defaults to 100. Example: 100.
    object_idstring
    16-character ID of the project or team member being added to the group. Example: Xf3kP9qL2mN8vB4w.
    offsetinteger
    Number of objects to skip, for paging. Defaults to 0. Example: 0.
    sort_bystring
    Comma-separated fields to sort by; prefix a field with - for descending order, for example -created_at,name. Example: -created_at,name.
  • nozbe_project_accesses_listList the project accesss the API token can access (who can see which project), optionally for one project.Read-only

    List Project Accesss

    List the project accesss the API token can access (who can see which project), optionally for one project. Returns an array of project access objects; page with limit and offset and trim fields with fields. Use nozbe_project_access_get for one project access by ID.

    Inputs

    fieldsstring
    Comma-separated list of fields to return for each object, for example id,name. Leave empty for all fields. Example: id,name,ended_at.
    limitinteger
    Maximum number of objects to return (1-10000). Defaults to 100. Example: 100.
    offsetinteger
    Number of objects to skip, for paging. Defaults to 0. Example: 0.
    sort_bystring
    Comma-separated fields to sort by; prefix a field with - for descending order, for example -created_at,name. Example: -created_at,name.
  • nozbe_project_getGet one project by its 16-character ID.Read-only

    Get Project

    Get one project by its 16-character ID. Returns the project object. Get IDs from nozbe_projects_list.

    Inputs

    project_idstringrequired
    16-character ID of the project. Example: Xf3kP9qL2mN8vB4w.
    fieldsstring
    Comma-separated list of fields to return for each object, for example id,name. Leave empty for all fields. Example: id,name,ended_at.
  • nozbe_project_group_getGet one project group by its 16-character ID.Read-only

    Get Project Group

    Get one project group by its 16-character ID. Returns the project group object. Get IDs from nozbe_project_groups_list.

    Inputs

    project_group_idstringrequired
    16-character ID of the project group. Example: Xf3kP9qL2mN8vB4w.
    fieldsstring
    Comma-separated list of fields to return for each object, for example id,name. Leave empty for all fields. Example: id,name,ended_at.
  • nozbe_project_groups_listList the project groups the API token can access (folders of projects).Read-only

    List Project Groups

    List the project groups the API token can access (folders of projects). Returns an array of project group objects; page with limit and offset and trim fields with fields. Use nozbe_project_group_get for one project group by ID.

    Inputs

    fieldsstring
    Comma-separated list of fields to return for each object, for example id,name. Leave empty for all fields. Example: id,name,ended_at.
    limitinteger
    Maximum number of objects to return (1-10000). Defaults to 100. Example: 100.
    namestring
    Name of the object. Example: Prepare Q3 board deck.
    offsetinteger
    Number of objects to skip, for paging. Defaults to 0. Example: 0.
    sort_bystring
    Comma-separated fields to sort by; prefix a field with - for descending order, for example -created_at,name. Example: -created_at,name.
    team_idstring
    16-character ID of the team (space). Get it from nozbe_teams_list. Example: Xf3kP9qL2mN8vB4w.