tiny-asana-mcp-server

tiny-asana-mcp-server

0
developer_toolsos_automationcommunication

The Asana MCP Server is a tool allowing AI assistants to interface with Asana using the Model Context Protocol. It supports various task management operations, seamlessly integrating with Asana’s environment to enhance productivity.

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 git@github.com: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.