asanamcp
MCP server for the Asana API.
Quick Start
-
Get an Asana Personal Access Token at https://app.asana.com/0/my-apps
-
Install:
# Homebrew
brew install adlio/tap/asanamcp
# From crates.io
cargo install asanamcp
# From GitHub
cargo install --git https://github.com/adlio/asanamcp
- Add to Claude Desktop config (
~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"asana": {
"command": "asanamcp",
"env": {
"ASANA_TOKEN": "your-personal-access-token",
"ASANA_DEFAULT_WORKSPACE": "your-workspace-gid"
}
}
}
}
The ASANA_DEFAULT_WORKSPACE is optional but recommended if you work primarily in one workspace. When set, workspace-based operations (search, list projects, list users, etc.) will use this default, reducing the need to specify workspace GID in every request.
Testing the Server
# Dump tool schemas (useful for debugging)
asanamcp --schema
# Dump a specific tool's schema
asanamcp --schema get
# Launch the MCP Inspector (interactive web UI)
make inspect
Tools
asana_get
Fetch any Asana resource with recursive traversal support.
{"resource_type": "portfolio", "gid": "123", "depth": -1}
*Uses ASANA_DEFAULT_WORKSPACE if gid is empty.
Depth: -1 = unlimited, 0 = none, N = N levels.
asana_create
{"resource_type": "task", "project_gid": "123", "name": "New task", "assignee": "me"}
*Uses ASANA_DEFAULT_WORKSPACE if not provided.
asana_update
{"resource_type": "task", "gid": "123", "completed": true}
Supports: task, project, portfolio, section, tag, comment, status_update, project_brief (Key Resources on Overview tab, NOT the Note tab).
asana_delete
Permanently delete an Asana resource. This action is irreversible.
{"resource_type": "task", "gid": "123"}
Supports: task, project, portfolio, section, tag, comment, status_update, project_brief.
asana_link
{"action": "add", "relationship": "task_project", "target_gid": "task123", "item_gid": "proj456"}
Use item_gid for single items or item_gids for bulk operations.
asana_task_search
Search for tasks with rich filtering options.
{"workspace_gid": "123", "text": "bug", "completed": false, "assignee": "me"}
asana_resource_search
Search for any Asana resource by name using typeahead. Use this to find projects, templates, users, teams, and more.
{"query": "CloudSmith", "resource_type": "project_template"}
Library Usage
use asanamcp::{AsanaClient, Resource};
#[tokio::main]
async fn main() -> Result<(), asanamcp::Error> {
let client = AsanaClient::from_env()?;
let workspaces: Vec<Resource> = client
.get_all("/workspaces", &[("opt_fields", "gid,name")])
.await?;
for ws in workspaces {
println!("{}: {:?}", ws.gid, ws.fields.get("name"));
}
Ok(())
}
Development
make ci # Run all checks (fmt, lint, build, docs, test)
make test # Run tests
make coverage # Coverage report
make fmt # Format code
make lint # Run clippy
make inspect # Open MCP Inspector web UI
make schema # Dump tool schemas to stdout
License
MIT