================== /// MCP /// /// MCP /// ================== [server:online] [protocol:ready]
mcp-server-asana
by roychri
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.
90
32
Open SourceInstallation
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 --save
3. 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 on
4. Build the TypeScript sources (only required if you are working from the Git repo)
npm run build
5. Start the server
npx mcp-server-asana start # or: npm run start
6. Check health
Visit http://localhost:8080/health or use `curl`:
curl http://localhost:8080/health
A 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 save
Documentation
License: MIT License
Updated 7/15/2025