mcp-server-asana
Author: roychri
Description: Model Context Protocol (MCP) server implementation that exposes Asana’s REST API as MCP tools, resources and prompts. Lets Claude Desktop / Code and other MCP clients interact with Asana workspaces, projects, tasks, comments, etc.
Stars: 90
Forks: 32
License: MIT License
Category: Open Source
Overview
Installation
1. Prerequisites
• Node.js ≥ 18 and npm (comes with Node)
• An Asana Personal Access Token (PAT) with read-write permissions for the workspace you want the MCP server to manage.
2. Install the package
# inside your existing MCP server workspace or a fresh folder
npm install mcp-server-asana --save3. Create a configuration file (e.g. .env or config/mcp-asana.json)
ASANA_ACCESS_TOKEN=<your-asana-pat>
ASANA_WORKSPACE_ID=<workspace-id>
PORT=8080 # port the MCP server should listen on4. Build the TypeScript sources (only required if you are working from the Git repo)
npm run build5. Start the server
npx mcp-server-asana start # or: npm run start6. Check health
Visit http://localhost:8080/health or use `curl`:
curl http://localhost:8080/healthA JSON payload like `{ "status": "ok" }` should be returned.
7. (Optional) Run as a background service
pm install -g pm2
pm2 start "npm run start" --name mcp-asana
pm2 saveLicense: MIT License
Updated 7/15/2025