Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Asana

Scalekit connector
Open markdown

The Asana connector lets your AI agent act in each user's Asana account. Each user signs in to Asana once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 210 tools.

Tools
210
What they doRead · write · destructive
101 · 86 · 23101 read86 write23 destructive
Users sign in with
OAuth app
Scalekit's or your own

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 Asana connection

    In AgentKit > Connections, create an Asana connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Asana, so you don't need to register an OAuth app. To show your own app on the consent screen, use your own credentials instead.

    Use your own OAuth app

    Register your Scalekit environment with the Asana connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

    1. Set up auth redirects

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Asana and click Create. Copy the redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

        Copy redirect URI from Scalekit dashboard

      • Go to Asana Developer Console and click Create new app. Enter an app name.

      • In the left menu, go to OAuth. Under Redirect URLs, click Add redirect URL, paste the redirect URI from Scalekit, and click Add.

        Add redirect URL in Asana Developer Console

    2. Enable multi-workspace install Optional

      Enable this if you want users outside your Asana workspace to install the app.

      • In your app settings, go to OAuth → App permissions.

      • Under App install permissions, enable Allow users outside your workspace to install this app.

        Enable multi-workspace install in Asana

    3. Get client credentials

    4. Add credentials in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the connection you created.

      • Enter your credentials:

        Add credentials in Scalekit dashboard

      • Click Save.

  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 = 'asana'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Asana:', 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: 'asana_allocations_list',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • asana_allocation_getGet a single resource allocation record by its GID.Read-only

    Get Allocation

    Get a single resource allocation record by its GID.

    Inputs

    allocation_gidstringrequired
    GID of the allocation to retrieve
    opt_fieldsstring
    Comma-separated list of optional fields to include in the response
  • asana_allocations_listList resource allocations.Read-only

    List Allocations

    List resource allocations. At least one of assignee_gid or parent_gid is required by the Asana API.

    Inputs

    assignee_gidstring
    GID of the user to filter allocations by assignee
    opt_fieldsstring
    Comma-separated list of optional fields to include in the response
    parent_gidstring
    GID of the parent project or portfolio to filter allocations by
  • asana_attachment_getGet details of a specific attachment by its GID.Read-only

    Get Attachment

    Get details of a specific attachment by its GID.

    Inputs

    attachment_gidstringrequired
    GID of the attachment to retrieve
    opt_fieldsstring
    Comma-separated list of optional fields to include in response
  • asana_attachments_listList all attachments for a task or project.Read-only

    List Attachments

    List all attachments for a task or project.

    Inputs

    parent_gidstringrequired
    GID of the task or project to list attachments for
    opt_fieldsstring
    Comma-separated list of optional fields to include in response
  • asana_audit_log_events_listList audit log events captured for a workspace domain since October 2021, optionally filtered by time range, event type, actor, or resource.Read-only

    List Audit Log Events

    List audit log events captured for a workspace domain since October 2021, optionally filtered by time range, event type, actor, or resource.

    Inputs

    workspace_gidstringrequired
    GID of the workspace or organization
    actor_gidstring
    Filter to events triggered by the actor with this GID
    end_atstring
    Filter to events created before this time (exclusive, ISO 8601)
    event_typestring
    Filter to events of this type
    resource_gidstring
    Filter to events with this resource GID
    start_atstring
    Filter to events created after this time (inclusive, ISO 8601)
  • asana_budget_getGet the full record for a single budget.Read-only

    Get Budget

    Get the full record for a single budget.

    Inputs

    budget_gidstringrequired
    GID of the budget to retrieve
    opt_fieldsstring
    Comma-separated list of optional fields to include in response
  • asana_budgets_listList the budgets for a given parent project.Read-only

    List Budgets

    List the budgets for a given parent project. Returns at most one budget per parent.

    Inputs

    parentstringrequired
    GID of the project to list budgets for
    opt_fieldsstring
    Comma-separated list of optional fields to include in response
  • asana_custom_field_getGet a custom field definition by its GID.Read-only

    Get Custom Field

    Get a custom field definition by its GID.

    Inputs

    custom_field_gidstringrequired
    GID of the custom field to retrieve
    opt_fieldsstring
    Comma-separated list of optional fields to include in response

Workflows

Proxy API call
const result = await actions.request({
  connectionName: 'asana',
  identifier: 'user_123',
  path: '/api/1.0/users/me',
  method: 'GET',
});
console.log(result);

Related: other Project Management connectors

All 40 in Project Management