Asana MCP Server
by jtalk22io.github.jtalk22/asana-mcp-serverv1.0.1
Change Asana without opening Asana — custom fields, sections, start dates, rich notes, bulk. PAT.
context tax
queued
security
queued
cold start
queued
freshness
Maintained55d ago
Install Asana MCP server
Install in Claude Code
claude mcp add asana -e ASANA_PAT='<asana-pat>' -- npx -y @jtalk22/asana-mcpInstall in Cursor
{
"mcpServers": {
"asana": {
"command": "npx",
"args": [
"-y",
"@jtalk22/asana-mcp"
],
"env": {
"ASANA_PAT": "<asana-pat>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"asana": {
"command": "npx",
"args": [
"-y",
"@jtalk22/asana-mcp"
],
"env": {
"ASANA_PAT": "<asana-pat>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"asana": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@jtalk22/asana-mcp"
],
"env": {
"ASANA_PAT": "<asana-pat>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"asana": {
"command": "npx",
"args": [
"-y",
"@jtalk22/asana-mcp"
],
"env": {
"ASANA_PAT": "<asana-pat>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ASANA_PAT | — | yes | Asana Personal Access Token (create at https://app.asana.com/0/my-apps). Optional when stored via `asana-mcp --setup` (macOS Keychain or ~/.asana-mcp.json). |
| ASANA_WORKSPACE_GID | — | — | Workspace GID. Optional — auto-detected when the token sees exactly one workspace. |
| ASANA_MCP_TOOLS | — | — | Tool surface filter: all | read | write | comma-list of tool names. |
Freshness
Maintained — last maintenance signal 55d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-15 · 55d ago · GitHub
Latest release
2026-08-15 · 55d ago · GitHub · v1.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-15 · 55d ago · official registry · v1.0.1
FAQ
›How do I install the Asana MCP server in Claude Code?
Run: claude mcp add asana -e ASANA_PAT='<asana-pat>' -- npx -y @jtalk22/asana-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Asana require an API key?
Yes. It expects ASANA_PAT, of which 1 is a secret.
›Can I use Asana as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Asana in the official MCP registry?
Yes, as io.github.jtalk22/asana-mcp-server.
Alternatives to Asana
Other project management MCP servers.