Can I use Asana as a CLI?

Yes. KosmoKrator exposes a Asana CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Asana through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Asana tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Asana credentials stored?

Asana credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Asana MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Asana CLI for AI Agents

Use the Asana CLI from KosmoKrator to call Asana tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

20 functions 13 read 7 write Bearer token auth

Submit Asana feedback View package source

Asana CLI Setup

Asana can be configured headlessly with `kosmokrator integrations:configure asana`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure asana --set access_token="$ASANA_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor asana --json
kosmokrator integrations:status --json

Credentials

Authentication type: Bearer token bearer_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`ASANA_ACCESS_TOKEN`	Secret `secret`	yes	Access Token

Call Asana Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call asana.asana_create_task '{
  "name": "example_name",
  "notes": "example_notes",
  "projects": "example_projects",
  "assignee": "example_assignee",
  "due_on": "example_due_on",
  "tags": "example_tags",
  "workspace": "example_workspace"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:asana asana_create_task '{
  "name": "example_name",
  "notes": "example_notes",
  "projects": "example_projects",
  "assignee": "example_assignee",
  "due_on": "example_due_on",
  "tags": "example_tags",
  "workspace": "example_workspace"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs asana --json
kosmo integrations:docs asana.asana_create_task --json
kosmo integrations:schema asana.asana_create_task --json
kosmo integrations:search "Asana" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Asana.

`asana.asana_create_task`

Write write

Create a new task in Asana.

Parameters: name, notes, projects, assignee, due_on, tags, workspace

Generic CLI call

kosmo integrations:call asana.asana_create_task '{"name":"example_name","notes":"example_notes","projects":"example_projects","assignee":"example_assignee","due_on":"example_due_on","tags":"example_tags","workspace":"example_workspace"}' --json

Provider shortcut

kosmo integrations:asana asana_create_task '{"name":"example_name","notes":"example_notes","projects":"example_projects","assignee":"example_assignee","due_on":"example_due_on","tags":"example_tags","workspace":"example_workspace"}' --json

`asana.asana_get_task`

Read read

Get detailed information about an Asana task.

Parameters: id

Generic CLI call

kosmo integrations:call asana.asana_get_task '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:asana asana_get_task '{"id":"example_id"}' --json

`asana.asana_update_task`

Write write

Update an existing Asana task.

Parameters: id, name, notes, assignee, due_on, completed, tags

Generic CLI call

kosmo integrations:call asana.asana_update_task '{"id":"example_id","name":"example_name","notes":"example_notes","assignee":"example_assignee","due_on":"example_due_on","completed":true,"tags":"example_tags"}' --json

Provider shortcut

kosmo integrations:asana asana_update_task '{"id":"example_id","name":"example_name","notes":"example_notes","assignee":"example_assignee","due_on":"example_due_on","completed":true,"tags":"example_tags"}' --json

`asana.asana_delete_task`

Write write

Delete an Asana task permanently.

Parameters: id

Generic CLI call

kosmo integrations:call asana.asana_delete_task '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:asana asana_delete_task '{"id":"example_id"}' --json

`asana.asana_list_tasks`

Read read

List tasks in Asana with optional filters.

Parameters: project, assignee, workspace, completed_since, limit, offset

Generic CLI call

kosmo integrations:call asana.asana_list_tasks '{"project":"example_project","assignee":"example_assignee","workspace":"example_workspace","completed_since":"example_completed_since","limit":1,"offset":"example_offset"}' --json

Provider shortcut

kosmo integrations:asana asana_list_tasks '{"project":"example_project","assignee":"example_assignee","workspace":"example_workspace","completed_since":"example_completed_since","limit":1,"offset":"example_offset"}' --json

`asana.asana_create_subtask`

Write write

Create a subtask under an existing Asana task.

Parameters: parent_id, name, notes, assignee

Generic CLI call

kosmo integrations:call asana.asana_create_subtask '{"parent_id":"example_parent_id","name":"example_name","notes":"example_notes","assignee":"example_assignee"}' --json

Provider shortcut

kosmo integrations:asana asana_create_subtask '{"parent_id":"example_parent_id","name":"example_name","notes":"example_notes","assignee":"example_assignee"}' --json

`asana.asana_add_comment`

Write write

Add a comment to an Asana task.

Parameters: task_id, text

Generic CLI call

kosmo integrations:call asana.asana_add_comment '{"task_id":"example_task_id","text":"example_text"}' --json

Provider shortcut

kosmo integrations:asana asana_add_comment '{"task_id":"example_task_id","text":"example_text"}' --json

`asana.asana_list_comments`

Read read

List comments (stories) on an Asana task.

Parameters: task_id, limit, offset

Generic CLI call

kosmo integrations:call asana.asana_list_comments '{"task_id":"example_task_id","limit":1,"offset":"example_offset"}' --json

Provider shortcut

kosmo integrations:asana asana_list_comments '{"task_id":"example_task_id","limit":1,"offset":"example_offset"}' --json

`asana.asana_create_project`

Write write

Create a new project in Asana.

Parameters: name, notes, workspace, team, color

Generic CLI call

kosmo integrations:call asana.asana_create_project '{"name":"example_name","notes":"example_notes","workspace":"example_workspace","team":"example_team","color":"example_color"}' --json

Provider shortcut

kosmo integrations:asana asana_create_project '{"name":"example_name","notes":"example_notes","workspace":"example_workspace","team":"example_team","color":"example_color"}' --json

`asana.asana_get_project`

Read read

Get detailed information about an Asana project.

Parameters: id

Generic CLI call

kosmo integrations:call asana.asana_get_project '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:asana asana_get_project '{"id":"example_id"}' --json

`asana.asana_list_projects`

Read read

List projects in Asana with optional filters.

Parameters: workspace, team, archived, limit, offset

Generic CLI call

kosmo integrations:call asana.asana_list_projects '{"workspace":"example_workspace","team":"example_team","archived":true,"limit":1,"offset":"example_offset"}' --json

Provider shortcut

kosmo integrations:asana asana_list_projects '{"workspace":"example_workspace","team":"example_team","archived":true,"limit":1,"offset":"example_offset"}' --json

`asana.asana_list_sections`

Read read

List sections in an Asana project.

Parameters: project_id, limit, offset

Generic CLI call

kosmo integrations:call asana.asana_list_sections '{"project_id":"example_project_id","limit":1,"offset":"example_offset"}' --json

Provider shortcut

kosmo integrations:asana asana_list_sections '{"project_id":"example_project_id","limit":1,"offset":"example_offset"}' --json

`asana.asana_list_workspaces`

Read read

List all workspaces the authenticated user has access to.

Parameters: none

Generic CLI call

kosmo integrations:call asana.asana_list_workspaces '{}' --json

Provider shortcut

kosmo integrations:asana asana_list_workspaces '{}' --json

`asana.asana_list_teams`

Read read

List teams in an Asana workspace.

Parameters: workspace_id

Generic CLI call

kosmo integrations:call asana.asana_list_teams '{"workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:asana asana_list_teams '{"workspace_id":"example_workspace_id"}' --json

`asana.asana_list_users`

Read read

List users in an Asana workspace.

Parameters: workspace, limit, offset

Generic CLI call

kosmo integrations:call asana.asana_list_users '{"workspace":"example_workspace","limit":1,"offset":"example_offset"}' --json

Provider shortcut

kosmo integrations:asana asana_list_users '{"workspace":"example_workspace","limit":1,"offset":"example_offset"}' --json

`asana.asana_get_user`

Read read

Get detailed information about an Asana user.

Parameters: id

Generic CLI call

kosmo integrations:call asana.asana_get_user '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:asana asana_get_user '{"id":"example_id"}' --json

`asana.asana_get_user_task_list`

Read read

Get the user task list for a given user and workspace.

Parameters: user_id, workspace_id

Generic CLI call

kosmo integrations:call asana.asana_get_user_task_list '{"user_id":"example_user_id","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:asana asana_get_user_task_list '{"user_id":"example_user_id","workspace_id":"example_workspace_id"}' --json

`asana.asana_list_tags`

Read read

List tags in an Asana workspace.

Parameters: workspace, limit, offset

Generic CLI call

kosmo integrations:call asana.asana_list_tags '{"workspace":"example_workspace","limit":1,"offset":"example_offset"}' --json

Provider shortcut

kosmo integrations:asana asana_list_tags '{"workspace":"example_workspace","limit":1,"offset":"example_offset"}' --json

`asana.asana_create_tag`

Write write

Create a new tag in Asana.

Parameters: name, workspace, color

Generic CLI call

kosmo integrations:call asana.asana_create_tag '{"name":"example_name","workspace":"example_workspace","color":"example_color"}' --json

Provider shortcut

kosmo integrations:asana asana_create_tag '{"name":"example_name","workspace":"example_workspace","color":"example_color"}' --json

`asana.asana_get_current_user`

Read read

Get the currently authenticated Asana user.

Parameters: none

Generic CLI call

kosmo integrations:call asana.asana_get_current_user '{}' --json

Provider shortcut

kosmo integrations:asana asana_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`asana.asana_create_task`

Create a new task in Asana.

Operation: Write write
Schema command: kosmo integrations:schema asana.asana_create_task --json

Parameter	Type	Required	Description
`name`	string	yes	Name of the task.
`notes`	string	no	Free-form textual description (supports HTML).
`projects`	array	no	Array of project GIDs to add the task to.
`assignee`	string	no	User GID to assign the task to, or "me".
`due_on`	string	no	Due date in YYYY-MM-DD format.
`tags`	array	no	Array of tag GIDs to add to the task.
`workspace`	string	no	Workspace GID (required if not adding to a project).

`asana.asana_get_task`

Get detailed information about an Asana task.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_get_task --json

Parameter	Type	Required	Description
`id`	string	yes	The task GID.

`asana.asana_update_task`

Update an existing Asana task.

Operation: Write write
Schema command: kosmo integrations:schema asana.asana_update_task --json

Parameter	Type	Required	Description
`id`	string	yes	The task GID to update.
`name`	string	no	New name for the task.
`notes`	string	no	New description.
`assignee`	string	no	User GID to assign the task to, or "me".
`due_on`	string	no	Due date in YYYY-MM-DD format.
`completed`	boolean	no	Set to true to mark the task complete.
`tags`	array	no	Array of tag GIDs to set on the task.

`asana.asana_delete_task`

Delete an Asana task permanently.

Operation: Write write
Schema command: kosmo integrations:schema asana.asana_delete_task --json

Parameter	Type	Required	Description
`id`	string	yes	The task GID to delete.

`asana.asana_list_tasks`

List tasks in Asana with optional filters.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_tasks --json

Parameter	Type	Required	Description
`project`	string	no	Project GID to filter tasks by.
`assignee`	string	no	User GID to filter by assignee, or "me".
`workspace`	string	no	Workspace GID to filter tasks by.
`completed_since`	string	no	Only return tasks completed after this ISO 8601 date.
`limit`	integer	no	Max number of tasks to return (1–100).
`offset`	string	no	Cursor for pagination from a previous response.

`asana.asana_create_subtask`

Create a subtask under an existing Asana task.

Operation: Write write
Schema command: kosmo integrations:schema asana.asana_create_subtask --json

Parameter	Type	Required	Description
`parent_id`	string	yes	GID of the parent task.
`name`	string	yes	Name of the subtask.
`notes`	string	no	Description for the subtask.
`assignee`	string	no	User GID to assign the subtask to, or "me".

`asana.asana_add_comment`

Add a comment to an Asana task.

Operation: Write write
Schema command: kosmo integrations:schema asana.asana_add_comment --json

Parameter	Type	Required	Description
`task_id`	string	yes	GID of the task to comment on.
`text`	string	yes	Comment text (supports Markdown).

`asana.asana_list_comments`

List comments (stories) on an Asana task.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_comments --json

Parameter	Type	Required	Description
`task_id`	string	yes	GID of the task to list comments for.
`limit`	integer	no	Max number of comments to return (1–100).
`offset`	string	no	Cursor for pagination from a previous response.

`asana.asana_create_project`

Create a new project in Asana.

Operation: Write write
Schema command: kosmo integrations:schema asana.asana_create_project --json

Parameter	Type	Required	Description
`name`	string	yes	Name of the project.
`notes`	string	no	Free-form description of the project.
`workspace`	string	yes	Workspace GID where the project will be created.
`team`	string	no	Team GID to add the project to.
`color`	string	no	Color for the project (e.g. "dark-pink", "dark-green").

`asana.asana_get_project`

Get detailed information about an Asana project.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_get_project --json

Parameter	Type	Required	Description
`id`	string	yes	The project GID.

`asana.asana_list_projects`

List projects in Asana with optional filters.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_projects --json

Parameter	Type	Required	Description
`workspace`	string	no	Workspace GID to filter projects by.
`team`	string	no	Team GID to filter projects by.
`archived`	boolean	no	Filter by archived status.
`limit`	integer	no	Max number of projects to return (1–100).
`offset`	string	no	Cursor for pagination from a previous response.

`asana.asana_list_sections`

List sections in an Asana project.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_sections --json

Parameter	Type	Required	Description
`project_id`	string	yes	GID of the project to list sections for.
`limit`	integer	no	Max number of sections to return (1–100).
`offset`	string	no	Cursor for pagination from a previous response.

`asana.asana_list_workspaces`

List all workspaces the authenticated user has access to.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_workspaces --json

Parameter	Type	Required	Description
No parameters.

`asana.asana_list_teams`

List teams in an Asana workspace.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_teams --json

Parameter	Type	Required	Description
`workspace_id`	string	yes	GID of the workspace to list teams for.

`asana.asana_list_users`

List users in an Asana workspace.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_users --json

Parameter	Type	Required	Description
`workspace`	string	yes	Workspace GID to filter users by.
`limit`	integer	no	Max number of users to return (1–100).
`offset`	string	no	Cursor for pagination from a previous response.

`asana.asana_get_user`

Get detailed information about an Asana user.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_get_user --json

Parameter	Type	Required	Description
`id`	string	yes	The user GID.

`asana.asana_get_user_task_list`

Get the user task list for a given user and workspace.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_get_user_task_list --json

Parameter	Type	Required	Description
`user_id`	string	yes	GID of the user.
`workspace_id`	string	yes	GID of the workspace.

`asana.asana_list_tags`

List tags in an Asana workspace.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_list_tags --json

Parameter	Type	Required	Description
`workspace`	string	yes	Workspace GID to filter tags by.
`limit`	integer	no	Max number of tags to return (1–100).
`offset`	string	no	Cursor for pagination from a previous response.

`asana.asana_create_tag`

Create a new tag in Asana.

Operation: Write write
Schema command: kosmo integrations:schema asana.asana_create_tag --json

Parameter	Type	Required	Description
`name`	string	yes	Name of the tag.
`workspace`	string	yes	Workspace GID where the tag will be created.
`color`	string	no	Color for the tag (e.g. "dark-pink", "dark-green").

`asana.asana_get_current_user`

Get the currently authenticated Asana user.

Operation: Read read
Schema command: kosmo integrations:schema asana.asana_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.