fluidapex/asana-mcp-server

Asana Organization MCP Server

A Model Context Protocol (MCP) server for comprehensive Asana project organization capabilities.

Features

• Task movement and organization
• Section management (CRUD operations)
• Bulk task operations
• Project analytics and reporting
• Full Asana API integration with rate limiting and retry logic

Installation

# Clone the repository
git clone https://github.com/fluidapex/asana-mcp-server.git
cd asana-mcp-server

# Set up virtual environment with uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e ".[dev]"

Configuration

1. Copy .env.example to .env:

cp .env.example .env

2. Edit .env and add your Asana credentials:

ASANA_ACCESS_TOKEN=your_asana_personal_access_token_here
ASANA_WORKSPACE_GID=your_default_workspace_gid_here

Usage

As MCP Server

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "asana-organization": {
      "command": "python",
      "args": ["-m", "asana_mcp.server"],
      "env": {
        "ASANA_ACCESS_TOKEN": "your_token_here",
        "ASANA_WORKSPACE_GID": "your_workspace_gid"
      }
    }
  }
}

Available Tools

• Task Management: Move tasks between projects and sections
• Section Operations: Create, update, delete, and reorder sections
• Bulk Operations: Batch task updates, bulk moves, and multi-select operations
• Analytics: Project progress tracking, workload analysis, and reporting

Development

Running Tests

# Run all tests with coverage
pytest

# Run only unit tests
pytest tests/unit

# Run with verbose output
pytest -vv

Code Quality

# Format code
ruff format .

# Lint code
ruff check .

# Type checking
mypy src/

# Run all checks
make lint

Project Structure

asana-mcp-server/
├── src/asana_mcp/         # Main package
│   ├── api/               # Asana API client
│   ├── models/            # Pydantic models
│   ├── managers/          # Business logic managers
│   ├── tools/             # MCP tool implementations
│   └── utils/             # Utilities and helpers
├── tests/                 # Test suite
└── docs/                  # Documentation

Contributing

Please read for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the MIT License - see the file for details.

Support

For issues and feature requests, please use the GitHub Issues page.