Asana MCP Connector for AI Agents

Paperclip’s Asana connector gives your AI agents tools to find tasks, read task details and update or comment on tasks through its MCP server. Each tool can be Allowed, Ask first or Off.

Agents act through the Asana account you authorize. Its workspace and project membership determines what they can reach.

What agents can do with Asana

Review tasks in a projectget_tasks · get_task
Add context to a taskget_task · add_comment
Update task detailsget_task · update_tasks

How to connect Asana

In Paperclip, open Connectors and select Asana.
On the Access step, choose the identity and which agents may use the connection.
Select Use your own OAuth app and copy Paperclip’s callback URI. Register an Asana app of type MCP app with that URI, then enter its client ID and secret in Paperclip and authorize the account.

Setup guide

Asana tools for agents27

Write 27

add_comment
Adds a comment to a task.
Full description
Adds a comment to a task. Supports plain text and HTML-formatted comments, @-mentions via GID references, and pinned comments. Use only for discussion, feedback, or context — not for actions Asana logs automatically (such as assignments or status changes).
create_project
Creates a new project immediately, without a confirmation step.
Full description
Creates a new project immediately, without a confirmation step. Optionally include sections and tasks in a single operation to set up the full project structure at creation time. Use create_project_preview in Claude or ChatGPT when you want to review the plan before creating.
create_project_preview
Drafts a structured project plan and presents it for review before creating it in Asana.
Full description
Drafts a structured project plan and presents it for review before creating it in Asana. Generates a project with sections, tasks, assignees, due dates, and priorities.
create_project_status_update
Posts a status update to a project or portfolio.
Full description
Posts a status update to a project or portfolio. Requires a title, a status color (green, yellow, red, blue, or complete), and body text. Supports plain text and HTML.
create_task_preview
Drafts a task and presents it for review before creating it in Asana.
Full description
Drafts a task and presents it for review before creating it in Asana. Use this when creating a single task and you want to confirm the details first. Fields in the preview: name, assignee, due date, start date, project, and section.
create_tasks
Creates one or more tasks immediately, without a confirmation step.
Full description
Creates one or more tasks immediately, without a confirmation step. Supports up to 50 tasks per call. Each task can specify a project, section, parent task (for subtasks), assignee, due date, start date, description, followers, and custom field values. Use create_task_preview in Claude or ChatGPT when you want to review before creating.

Show all 27 Write tools

delete_task
Permanently deletes a task and any of its subtasks that are not also members of another project.
Full description
Permanently deletes a task and any of its subtasks that are not also members of another project. This action cannot be undone.
get_agent
Returns the full record for a single AI Teammate agent by GID.
Full description
Returns the full record for a single AI Teammate agent by GID. Includes name, description, behavior guidance, workspace, and photo. Use get_workspace_agents first to discover agent GIDs, then call this tool for full details on a specific agent.
get_attachments
Returns attachments for a task, project, or project brief.
Full description
Returns attachments for a task, project, or project brief. Includes file names, download URLs, and view URLs.
get_items_for_portfolio
Returns the items inside a portfolio, including projects and goals with their names and IDs.
get_me
Returns the name, email, and workspace memberships of the currently authenticated user.
Full description
Returns the name, email, and workspace memberships of the currently authenticated user. Use when you need specific details about the authenticated user rather than just their GID.
get_my_tasks
Returns tasks assigned to the currently authenticated user.
Full description
Returns tasks assigned to the currently authenticated user. A shortcut for common "what's on my plate" queries. Supports filtering by completion status.
get_portfolio
Returns full details for a single portfolio, including name, owner, and associated projects.
get_portfolios
Returns a list of portfolios owned by the authenticated user in the current workspace.
get_project
Returns full details for a single project: name, description, owner, member list, task counts, and optionally the project's sections.
get_projects
Returns a list of projects in the workspace.
Full description
Returns a list of projects in the workspace. Optionally filter by team or include archived projects.
get_status_overview
Returns an aggregated status report for one or more projects or portfolios based on keyword search.
Full description
Returns an aggregated status report for one or more projects or portfolios based on keyword search. Includes project details, current status updates, task summaries, and flagged blockers. This tool handles its own search internally — do not chain other search tools before calling it.
get_task
Returns full details for a single task: name, description, assignee, due dates, custom fields, project memberships, dependencies, subtasks, and comments.
get_tasks
Returns a filtered list of tasks by context.
Full description
Returns a filtered list of tasks by context. Requires at least one filter: project, section, tag, user task list, or assignee. Supports additional filters for completion status and modification date.
get_teams
Returns a list of teams in the workspace.
Full description
Returns a list of teams in the workspace. Optionally filter to only teams a specific user belongs to.
get_user
Returns details for a user by GID, email address, or the string "me".
Full description
Returns details for a user by GID, email address, or the string "me". Returns name, email, and workspace memberships. When called without a user identifier, returns the authenticated user.
get_users
Returns a list of users in the workspace.
Full description
Returns a list of users in the workspace. Optionally filter by team membership. Supports pagination for large workspaces.
get_workspace_agents
Returns a list of AI Teammate agents configured in the workspace.
Full description
Returns a list of AI Teammate agents configured in the workspace. Each record includes GID, name, resource type, and resource subtype. Use this to discover available AI Teammates before fetching full details with get_agent. Supports pagination. Note: this returns AI Teammates only — not human users. Use get_users for people.
search_objects
Universal search across Asana resource types.
Full description
Universal search across Asana resource types. Use this as the first step when you don't know the GID of an object. Supports tasks, projects, portfolios, goals, teams, users, tags, custom fields, and AI Teammates. V2 does not include a dedicated goals tool — use search_objects with resource_type: goal to find goals by name or partial match. Use resource_type: agent to search for AI Teammates specifically, or resource_type: actor to search for both humans and AI Teammates together — useful when finding anything that can be assigned work.
search_tasks
Advanced task search with full-text and complex filters.
Full description
Advanced task search with full-text and complex filters. Searches task names, descriptions, and comments. Supports filtering by assignee, due date, creation date, project, section, tag, and custom fields. Available on Premium accounts only; use get_tasks for non-Premium workspaces.
search_tasks_preview
Searches for tasks and displays results in an interactive UI.
Full description
Searches for tasks and displays results in an interactive UI. Supports filtering by assignee, due date range, start date, completion status, and text search.
update_tasks
Updates one or more tasks in a single operation.
Full description
Updates one or more tasks in a single operation. Supports up to 50 tasks per call. Fields that can be updated include name, assignee, due date, start date, description, completion status, parent, dependencies, dependents, project membership, followers, and custom fields.

Tool availability and permissions

This provider-published list describes the server’s tools. Authorization and feature access can reduce the tools available on your connection.

These lists use a conservative permission policy. Read requires a provider read-only hint or a reviewed Paperclip read rule. Evidence that an action changes data or submits information elsewhere puts it in Write. Write also includes actions we cannot verify as read-only. Read describes the reviewed evidence; it does not guarantee that an action has no side effects. A connected account can group actions differently.

This list comes from published provider information. Authorization, plan, deployment version and account settings can limit the actions available. No connected account was tested.

Connection policies

Discovered actions become active under the connection’s existing policies. Review the list after each refresh. You can set any tool to Ask first or Off. Task changes and comments appear to your team under the authorizing account.

Asana connector FAQ

Can I require approval for changes?

Set actions that change data to Ask first to require human approval of each call or Off to prevent calls. Allowed actions run without approval. Read and Write grouping is separate from these settings.

What can agents reach in Asana?

Agents can reach the workspaces and projects the authorizing Asana account can open. Paperclip has no workspace or project picker. Narrow reach through the account’s project membership.

What do I need before connecting?

Register your own Asana OAuth app of type MCP app and add the exact callback URI shown by Paperclip. Automatic client registration is not supported. Your organization may restrict app creation or authorization.