Asana MCP Server
Description
# Asana MCP Server A Model Context Protocol (MCP) server implementation for Asana integration. This package enables AI assistants to interact with Asana through a standardized protocol, allowing them to manage tasks, projects, and other Asana resources. ## Features - Asana task…
About
# Asana MCP Server A Model Context Protocol (MCP) server implementation for Asana integration. This package enables AI assistants to interact with Asana through a standardized protocol, allowing them to manage tasks, projects, and other Asana resources. ## Features - Asana task management through MCP - Project and…
Details
- Author
- bnwebdev
- Downloads
- 284
- Categories
- Other
Jump to
- Asana task management through MCP protocol
- List all accessible projects
- Retrieve sections within a project
- Get comments (stories) on a task
- Fetch details of a specific task
- List tasks by project or by section
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Asana MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install globally via npm install -g tiny-asana-mcp-server or run directly with npx tiny-asana-mcp-server. Before starting, set the ASANA_TOKEN environment variable to your Asana Personal Access Token (obtain from Asana Developer Console). Start the server with env ASANA_TOKEN=your_token npx -y tiny-asana-mcp-server, then connect an MCP client to begin using the provided tools.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"asana mcp server": {
"tiny-asana-mcp-server": {
"command": "npx",
"args": [
"tiny-asana-mcp-server"
]
}
}
}
}McpServers
{
"tiny-asana-mcp-server": {
"command": "npx",
"args": [
"tiny-asana-mcp-server"
]
}
}Asana MCP Server
A Model Context Protocol (MCP) server implementation for Asana integration. This package enables AI assistants to interact with Asana through a standardized protocol, allowing them to manage tasks, projects, and other Asana resources.
Features
- Asana task management through MCP
- Project and section listing
- Task comments retrieval
- Seamless integration with AI assistants
Installation
You can install this package globally using npm:
npm install -g tiny-asana-mcp-server
Or run it directly using npx:
npx tiny-asana-mcp-server
Configuration
Before using the server, you need to set up your Asana credentials. Create a .env file in your project root with the following content or provide envs via command line:
ASANA_TOKEN=your_asana_personal_access_token
or
env ASANA_TOKEN=your_asana_personal_access_token npx -y tiny-asana-mcp-server
You can obtain your Asana Personal Access Token from Asana Developer Console.
Usage
Starting the Server
env ASANA_TOKEN=... npx -y tiny-asana-mcp-server
The server will start and connect to the MCP client, allowing AI assistants to interact with your Asana workspace.
Available Tools
The server provides the following MCP tools:
- asana_get_projects: List all accessible projects
- asana_get_sections_by_project: List sections in a project
- asana_get_task_stories: Get comments on a task
- asana_get_task: Retrieve details of a specific task
- asana_get_tasks_by_project: List tasks in a project
- asana_get_tasks_by_section: List tasks in a section
Plans
- [x] Create MVP to provide asana integration
- [ ] Add environment-based tool configuration (enable/disable specific tools via environment variables)
- [ ] Cover all existing endpoints
Development
To set up the development environment:
1. Clone the repository:
git clone git@github.com:bnwebdev/tiny-asana-mcp-server.git
cd tiny-asana-mcp-server
2. Install dependencies:
yarn install
3. Start in development mode:
yarn dev
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Third-Party Licenses
This software uses the Asana Node.js client library, which is licensed under the Apache License, Version 2.0.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
