Asana Universal MCP Server

What is Asana Universal MCP Server about?

Provides an implementation of a Universal MCP server that exposes Asana functionality via a consistent, model‑context protocol, enabling seamless integration with other MCP‑compliant services.

How to use Asana Universal MCP Server?

1. Install the development dependencies with uv: uv sync.
2. Activate the virtual environment (source .venv/bin/activate on Linux/macOS or .venv\Scripts\Activate on Windows).
3. Launch the MCP inspector: mcp dev src/universal_mcp_asana/server.py and note the displayed address.
4. Install the application into your MCP ecosystem: mcp install src/universal_mcp_asana/server.py.
5. Access Asana via the MCP endpoint or through the web UI at agentr.dev → Apps → Asana.

Key features of Asana Universal MCP Server

• Full compliance with the MCP specification for cross‑service compatibility.
• Python 3.11+ implementation using the lightweight uv package manager.
• Ready‑to‑use tools list described in src/universal_mcp_asana/README.md.
• Simple local development workflow with built‑in inspector and installer commands.
• MIT‑licensed, making it free for commercial and personal use.

Use cases of Asana Universal MCP Server

• Integrate Asana task management into custom AI agents or automation pipelines.
• Bridge Asana with other MCP‑compatible services such as project tracking, knowledge bases, or analytics platforms.
• Prototype workflow automations without writing bespoke Asana API wrappers.
• Deploy a centralized Asana gateway in a micro‑services architecture.

FAQ from the Asana Universal MCP Server

Q: Do I need an Asana API token? A: Yes. Set your token in the .env file (e.g., ASANA_TOKEN=your_api_key) before starting the server.

Q: Can I run this server in production? A: The server is production‑ready, but you should manage secrets securely and consider containerizing the application.

Q: Which Python version is required? A: Python 3.11 or newer is recommended.

Q: Is there support for Windows development? A: Yes. Activate the virtual environment with PowerShell (.venv\Scripts\Activate).

Q: Where can I find the list of available Asana tools? A: See src/universal_mcp_asana/README.md for a comprehensive list.

Asana Universal MCP Server

This repository contains an implementation of an Asana Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Asana's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Asana directly from agentr.dev. Visit agentr.dev/apps and enable Asana.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_asana/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

• Python 3.11+ (recommended)
• uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

1. Sync Project Dependencies

   uv sync
   

   This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

2. Activate the Virtual Environment

   For Linux/macOS:

   source .venv/bin/activate
   

   For Windows (PowerShell):

   .venv\Scripts\Activate
   

3. Start the MCP Inspector

   mcp dev src/universal_mcp_asana/server.py
   

   This will start the MCP inspector. Make note of the address and port shown in the console output.

4. Install the Application

   mcp install src/universal_mcp_asana/server.py
   

📁 Project Structure

.
├── src/
│   └── universal_mcp_asana/
│       ├── __init__.py       # Package initializer
│       ├── server.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.

---

Generated with MCP CLI — Happy coding! 🚀