Asana

🚀 Asana MCP Server

Asana MCP Server is a tool that provides a series of APIs to manage Asana workspaces, projects, tasks, etc., facilitating users to operate Asana through programming.

🚀 Quick Start

📦 Installation

1. Install Dependencies:

   • Use npm to install the required packages:

     npm install @cristip73/mcp-server-asana
     

2. Run the MCP Server:

   • Create an index.js file in the project root directory and add the following content:

     const { AsanaMCP } = require('@cristip73/mcp-server-asana');
     const server = new AsanaMCP({
       env: {
         ASANA_ACCESS_TOKEN: 'your-asana-access-token',
         DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
       }
     });
     server.run();
     

   • Start the server:

     node index.js
     

⚙️ Configuration

Environment Variables

In the index.js file, you can customize the following environment variables:

const { AsanaMCP } = require('@cristip73/mcp-server-asana');
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token', // Required: Your Asana personal access token
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id', // Optional: Default workspace ID
    PAGE_SIZE: 50, // Optional: Number of items per page, default is 50
    DEBUG_MODE: false // Optional: Enable debug mode, default is false
  }
});
server.run();

Example

Here is a complete MCP configuration example:

const { AsanaMCP } = require('@cristip73/mcp-server-asana');

// Create an MCP instance
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});

// Define a custom command
server.defineCommand('asana.task.create', async (args) => {
  // Implement your task creation logic here
});

// Start the server
server.run();

💻 Usage Examples

Basic Usage

const { AsanaMCP } = require('@cristip73/mcp-server-asana');
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});
server.run();

Advanced Usage

const { AsanaMCP } = require('@cristip73/mcp-server-asana');

// Create an MCP instance
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});

// Define a custom command
server.defineCommand('asana.task.create', async (args) => {
  // Implement your task creation logic here
});

// Start the server
server.run();

📚 Documentation

API Interfaces

The following are the Asana-related interfaces provided by MCP:

Workspace Management

• asana.workspaces.list

  • Get all available workspaces.
  • Returns: A list of workspaces.

• asana.workspace.select

  • Set the default workspace.
  • Parameters:
    • workspace_id: The ID of the workspace to set as the default.
  • Returns: A confirmation message.

Project Management

• asana.projects.list

  • Get all projects in a specified workspace.
  • Parameters:
    • workspace_id: Workspace ID (optional, default is the default workspace).
  • Returns: A list of projects.

• asana.project.create

  • Create a new project.
  • Parameters:
    • project_name: Project name.
    • workspace_id: Target workspace ID (optional, default is the default workspace).
  • Returns: Detailed information of the newly created project.

Task Management

• asana.tasks.create

  • Create a new task.
  • Parameters:
    • project_id: Project ID.
    • task_name: Task name.
    • description: Task description (optional).
  • Returns: Detailed information of the newly created task.

• asana.task.update

  • Update an existing task.
  • Parameters:
    • task_id: Task ID.
    • updates: Update fields, e.g., { status: 'in-progress', due_date: '2023-10-10' }.
  • Returns: Detailed information of the updated task.

Team Management

• asana.teams.list

  • Get all teams.
  • Returns: A list of teams.

• asana.team.members.get

  • Get members of a specified team.
  • Parameters:
    • team_id: Team ID.
  • Returns: A list of members.

Reports and Statistics

• asana.reports.generate

  • Generate a project report.
  • Parameters:
    • project_id: Project ID.
  • Returns: Report data.

• asana.statistics.get

  • Get statistical data of a specified workspace.
  • Returns: Statistical information, including task completion rate, number of projects, etc.

Tips

Task Summary Tip

const { AsanaMCP } = require('@cristip73/mcp-server-asana');

// Create an MCP instance and define a command
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});

server.defineCommand('asana.task.summary', async (args) => {
  // Implement your task summary logic here
});

Status Update Tip

const { AsanaMCP } = require('@cristip73/mcp-server-asana');

// Create an MCP instance and define a command
const server = new AsanaMCP({
  env: {
    ASANA_ACCESS_TOKEN: 'your-asana-access-token',
    DEFAULT_WORKSPACE_ID: 'your-default-workspace-id'
  }
});

server.defineCommand('asana.status.update', async (args) => {
  // Implement your status update logic here
});

🔧 Troubleshooting

Common Issues

• Cannot connect to Asana:

  • Check if your ASANA_ACCESS_TOKEN is valid.
  • Ensure you have the correct permissions.

• Workspace not set:

  • Specify DEFAULT_WORKSPACE_ID or explicitly specify the workspace ID in the command.

🤝 Contribution

How to Contribute

1. Submit issues and suggestions to the GitHub repository.
2. Create a pull request to fix issues or add new features.

git clone https://github.com/yourusername/mcp-server-asana.git
cd mcp-server-asana
npm install

📄 License

This project is licensed under the MIT License. The full text of the license is as follows:

MIT License

Copyright (c) 2023 Your Name

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Thank you for using the Asana MCP Server! If you have any questions, please feel free to contact the maintenance team.