Added Asana MCP Server with workspace org, tags, timleines, etc #33
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add Asana MCP Server
Overview
New MCP server providing comprehensive integration with Asana's work management platform. Enables task management, project tracking, team collaboration, and workflow automation through 18 REST API tools.
Features
Core Functionality
Workspace Management: Access and list multiple workspaces and organizations
Project Planning: Create, update, and manage projects with full lifecycle support
Task Management: Complete CRUD operations for tasks with rich metadata
Section Organization: Structure projects using sections for better organization
Tag System: Flexible categorization across workspaces
Portfolio Management: Group and track multiple projects
User Management: Access user information and workspace members
Advanced Search: Multi-resource search across tasks, projects, and more
Asana-Specific Features
Workspace → Project → Section → Task hierarchy
Custom fields for metadata (text, number, dropdown, date)
Task dependencies (predecessor/successor relationships)
Subtasks for work breakdown
Assignees and followers for collaboration
Comments (stories) for context and audit trail
Due dates and scheduling
Multiple view support (Timeline, Board, Calendar)
Implementation Details
API Tools (18 total)
Workspaces: list_workspaces, get_workspace
Projects: list_projects, get_project, create_project, update_project
Tasks: list_tasks, get_task, create_task, update_task, delete_task, add_comment_to_task
Sections: list_sections, create_section
Tags: list_tags, create_tag
Portfolios: list_portfolios
Search: search_workspace
Technical Stack
Authentication: Bearer token via ASANA_PERSONAL_ACCESS_TOKEN
Base URL: https://app.asana.com/api/1.0
Rate Limit: 1,500 requests/minute
Resource IDs: String-based GIDs (e.g., "1234567890")
Advanced Parameters:
opt_fields for selective field fetching
opt_expand for nested resource expansion
Pagination with offset and limit
Files Added
servers/asana/server.py - Main server implementation
servers/asana/requirements.txt - Dependencies (fastmcp, httpx, python-dotenv, uvicorn)
servers/asana/server.json - NimbleTools registry configuration
servers/asana/Dockerfile - Python 3.11-slim container
servers/asana/test.json - Test cases for workspaces, projects, tasks
servers/asana/README.md - Comprehensive documentation
Registry Configuration
Name: ai.nimbletools/asana
Category: business-finance
Status: active
Version: 1.0.0
Testing
Includes 3 test cases covering core functionality:
List Workspaces
List Projects (with workspace filter)
List Tasks (with project filter)
Documentation
Complete README with:
Tool reference and parameters
Asana hierarchy explanation
Authentication setup
Usage examples and workflows
API rate limits and best practices
API Reference
Official documentation: https://developers.asana.com/docs