MCP Server for Asana

You can run an MCP Server for Asana to talk directly to the Asana API from your MCP Client, enabling natural language tools to create, read, and manage tasks, projects, workspaces, and comments using your preferred AI assistant.

How to use

You will connect your MCP Client to the Asana MCP Server and start asking questions about workspaces, projects, tasks, and comments. The server exposes a set of tools that let you list workspaces, search for projects and tasks, fetch detailed task or project data, create and update tasks, add stories or comments, manage dependencies, and retrieve task counts and sections. Include the word asana in your query to help the assistant route your request to the correct tool.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

1. Install the MCP server package via npm or npmx (as shown in the setup snippet). 2) Provide your Asana access token to enable API calls. 3) Start the MCP server using the configured runtime command.

{
  "mcpServers": {
    "asana": {
      "command": "npx",
      "args": ["-y", "@roychri/mcp-server-asana"],
      "env": {
        "ASANA_ACCESS_TOKEN": "your-asana-access-token"
      }
    }
  }
}

Additional setup and notes

Environment variables are used to store sensitive information like your Asana access token. Keep this token secret and avoid committing it to version control.

Troubleshooting

If you encounter permission errors, verify that your Asana plan includes API access and that the access token is correctly configured in your runtime environment.

Contributing

If you want to contribute, clone the project, install dependencies, and run local tests to verify MCP interactions with Asana.

License

This MCP server is licensed under the MIT License. You can use, modify, and distribute it under the terms of that license.

Available tools

asana_list_workspaces

List all available Asana workspaces with optional fields to include in the response.

asana_search_projects

Search for projects within a workspace by a name pattern, with optional filters for archived status and additional fields.

asana_search_tasks

Find tasks in a workspace using text, filters like assignee, projects, sections, and multiple sort options with optional fields.

asana_get_task

Retrieve detailed information about a specific task, with optional fields to include.

asana_create_task

Create a new task in a specified project, with optional notes, due date, and assignee.

asana_get_task_stories

Get comments and stories associated with a specific task.

asana_update_task

Update details of an existing task, including name, notes, due date, assignee, and completion status.

asana_get_project

Fetch detailed information about a specific project with optional fields.

asana_get_project_task_counts

Retrieve the number of tasks in a project with optional fields.

asana_get_project_sections

Get the sections contained in a project.

asana_create_task_story

Create a comment or story on a task.

asana_add_task_dependencies

Set dependencies for a task.

asana_add_task_dependents

Set dependents for a task.

asana_create_subtask

Create a subtask under a parent task with optional fields.

asana_get_multiple_tasks_by_gid

Fetch detailed information for multiple tasks by their GIDs (up to 25).