mcpField
A
Asana MCP Server

Asana MCP Server

Local
github.com/bnwebdevProductivity0Updated 85w ago
Repository

About Asana MCP Server

Asana MCP Server connects AI assistants to Asana for managing tasks and exploring projects. It offers focused tools for project, section, task, and comment retrieval.

Key features

  1. 01Manage Asana tasks
  2. 02List projects and sections
  3. 03Retrieve task details
  4. 04Read task comments

Use cases

  1. 01Review tasks in a project
  2. 02Find tasks in a section
  3. 03Check comments on a task

MCP support

Exposes Asana project, section, task, and comment operations as MCP tools for AI assistants.

#asana#mcp#integration#ai-assistant

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tiny-asana": {
      "command": "npx",
      "args": [
        "-y",
        "tiny-asana-mcp-server"
      ]
    }
  }
}
Run commandnpx -y tiny-asana-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmtiny-asana-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Asana MCP Server

A Model Context Protocol (MCP) server implementation for Asana integration. This package enables AI assistants to interact with Asana through a standardized protocol, allowing them to manage tasks, projects, and other Asana resources.

Features

  • Asana task management through MCP
  • Project and section listing
  • Task comments retrieval
  • Seamless integration with AI assistants

Installation

You can install this package globally using npm:

npm install -g tiny-asana-mcp-server

Or run it directly using npx:

npx tiny-asana-mcp-server

Configuration

Before using the server, you need to set up your Asana credentials. Create a .env file in your project root with the following content or provide envs via command line:

ASANA_TOKEN=your_asana_personal_access_token

or

env ASANA_TOKEN=your_asana_personal_access_token npx -y tiny-asana-mcp-server

You can obtain your Asana Personal Access Token from Asana Developer Console.

Usage

Starting the Server
env ASANA_TOKEN=... npx -y tiny-asana-mcp-server

The server will start and connect to the MCP client, allowing AI assistants to interact with your Asana workspace.

Available Tools

The server provides the following MCP tools:

  • asana_get_projects: List all accessible projects
  • asana_get_sections_by_project: List sections in a project
  • asana_get_task_stories: Get comments on a task
  • asana_get_task: Retrieve details of a specific task
  • asana_get_tasks_by_project: List tasks in a project
  • asana_get_tasks_by_section: List tasks in a section

Plans

  • Create MVP to provide asana integration
  • Add environment-based tool configuration (enable/disable specific tools via environment variables)
  • Cover all existing endpoints

Development

To set up the development environment:

  1. Clone the repository:
git clone [email protected]:bnwebdev/tiny-asana-mcp-server.git
cd tiny-asana-mcp-server
  1. Install dependencies:
yarn install
  1. Start in development mode:
yarn dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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

Third-Party Licenses

This software uses the Asana Node.js client library, which is licensed under the Apache License, Version 2.0.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.