Skip to main content
The @guildai-services/cwaddingham~asana package gives your agents access to Asana projects, tasks, and workspaces — a community integration published to the Guild Agent Hub. With it, agents can create and update tasks, query project status, and act on work items automatically, keeping Asana in sync without manual handoffs.

​
Authentication

  • Type: API key
  • Token management: Connect with an Asana personal access token. The token is sent as a bearer token (authorization: Bearer {token}) and does not expire until you revoke it.

​
Setup

1

Open Credentials

Go to Credentials in Guild.
2

Connect Asana

Click Asana and enter your Asana personal access token.

​
Usage

import { AsanaTools } from "@guildai-services/cwaddingham~asana"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that manages Asana tasks",
  tools: { ...AsanaTools },
})

​
Selecting specific tools

The integration exposes the full Asana REST API — around 240 operations — as tools, each named with the asana_ prefix and the operation in snake_case (for example, the getWorkspaceEvents endpoint becomes asana_get_workspace_events). That’s a large surface, so use pick() to include only the operations your agent needs: 
import { AsanaTools } from "@guildai-services/cwaddingham~asana"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that triages Asana tasks",
  tools: {
    ...pick(AsanaTools, [
      "asana_get_tasks",
      "asana_get_task",
      "asana_update_task",
      "asana_create_story_for_task",
    ]),
  },
})
See Tool sets for more on selecting specific tools.