MCP Server for Asana logo

MCP Server for Asana

by roychri

This is a Model Context Protocol (MCP) server implementation for Asana, enabling communication with the Asana API from MCP clients like Anthropic's Claude Desktop. It allows you to interact with your Asana tasks, projects, and workspaces using AI tools.

View on GitHub

Last updated: N/A

What is MCP Server for Asana?

This server acts as a bridge between AI tools that support the Model Context Protocol (MCP) and the Asana API. It allows AI tools to query and manipulate data within Asana, such as tasks, projects, and workspaces, using natural language.

How to use MCP Server for Asana?

To use this server, you need to configure your AI tool (e.g., Claude Desktop) with the server details and your Asana access token. Then, you can ask questions or give commands related to your Asana data within the AI tool, mentioning 'asana' to help the AI select the correct tool. Refer to the 'Usage' and 'Setup' sections in the README for detailed instructions.

Key features of MCP Server for Asana

  • Provides a set of tools for interacting with Asana's API (e.g., listing workspaces, searching projects/tasks, creating tasks, getting task details, etc.)

  • Supports advanced filtering options for task searches (e.g., by assignee, project, section, tags, completion status, etc.)

  • Exposes Asana workspaces and projects as resources that can be accessed via URIs.

  • Includes example prompts for common Asana-related tasks.

  • Supports creating and managing project statuses.

Use cases of MCP Server for Asana

  • Summarize the status of a project's tasks.

  • Create new tasks in Asana using natural language commands.

  • Find all incomplete tasks assigned to a specific person.

  • Get a list of all projects in a workspace.

  • Analyze if a task description contains all necessary details for completion

FAQ from MCP Server for Asana

How do I get an Asana access token?

You can generate a personal access token from the Asana developer console: https://app.asana.com/0/my-apps. More details here: https://developers.asana.com/docs/personal-access-token

What AI tools are compatible with this server?

This server is designed to work with any AI tool that supports the Model Context Protocol (MCP), such as Anthropic's Claude Desktop.

How do I configure Claude Desktop to use this server?

Add the server configuration to your claude_desktop_config.json file, including the command, arguments, and environment variables (ASANA_ACCESS_TOKEN). See the 'Setup' section in the README for detailed instructions.

What if I encounter permission errors?

Ensure your Asana plan allows API access and that your access token and configuration are correctly set in claude_desktop_config.json.

How can I test my changes locally?

You can use the MCP Inspector by running npm run inspector. This will expose the client to port 5173 and the server to port 3000.