Taiga MCP Server

A powerfulModel Context Protocol (MCP)server that enables natural language interaction withTaiga project managementsystems. Seamlessly manage your projects, sprints, user stories, tasks, and issues through conversational AI.

🤖AI-Powered Development: This project was developed collaboratively withClaude Code(claude.ai/code), showcasing the potential of AI-assisted software development.

- Projects: List and view project details
- Sprints: Create, list, and track sprint progress with detailed statistics
- User Stories: Create and manage user stories within projects
- Tasks: Create tasks linked to user stories
- Issues: Full issue lifecycle management with sprint associations

- View issues by sprint with complete relationship mapping
- Get detailed issue information including sprint assignments
- Track sprint progress with completion statistics
- Real-time status updates and progress monitoring

- Batch Create Issues: Create multiple issues in one operation (up to 20)
- Batch Create User Stories: Bulk create user stories with story points
- Batch Create Tasks: Mass create tasks for specific user stories
- Smart Error Handling: Individual failures don't affect other items
- Detailed Reporting: Success/failure status for each item

- SQL-like Query Language: Usefield:operator:valuesyntax for precise searches
- Logical Operators: Combine conditions with AND, OR, NOT
- Text Matching: Fuzzy search, wildcards, and substring matching
- Date Ranges: Flexible time-based queries (today, last_week, >7d)
- Sorting & Limiting: ORDER BY and LIMIT clauses for result control

- Comment Management: Add, view, edit, and delete comments on any work item
- Discussion Threads: Complete comment history with user information
- Team Communication: Enhanced collaboration through structured discussions
- Real-time Updates: Immediate comment synchronization across team

- Flexible File Upload: Support both file path and Base64 upload methods
- Claude Client Integration: Optimized for Claude Desktop file handling
- Multi-format Support: Images, documents, PDFs, and all major file types
- Smart Path Resolution: Automatic file path detection from common locations
- Download Management: Efficient file download with path management
- Storage Organization: Clean attachment management with descriptions

- Large-scale Organization: Create and manage Epic-level project components
- Hierarchical Structure: Link User Stories to Epics for complete project visibility
- Progress Tracking: Epic-level progress statistics and completion tracking
- Enterprise Planning: Support for roadmap planning and feature releases

- Documentation Hub: Create and manage project Wiki pages for knowledge sharing
- Markdown Support: Full Markdown editing with rich content formatting
- Flexible Identification: Access pages by ID or user-friendly slug names
- Collaboration Features: Watch/unwatch pages for change notifications
- Version Control: Automatic versioning prevents edit conflicts
- Content Organization: Centralized documentation management per project

- "List all projects"
- "Show me Sprint 5 progress statistics"
- "Create a high-priority bug issue in project X"
- "Which issues are assigned to Sprint 3?"
- "Get details for issue #123"

- Node.js(v14 or higher) -Download here
- Taiga accountwith API access

# NPM Registry (official) npx taiga-mcp-server # GitHub Package Registry (alternative) npx @greddy7574/taiga-mcp-server

# From NPM Registry npm install -g taiga-mcp-server taiga-mcp # From GitHub Packages npm install -g @greddy7574/taiga-mcp-server

# Build the image docker build -t taiga-mcp-server . # Run with environment file docker run --rm -i --env-file .env taiga-mcp-server # Or with environment variables docker run --rm -i \ -e TAIGA_API_URL=https://api.taiga.io/api/v1 \ -e TAIGA_USERNAME=your_username \ -e TAIGA_PASSWORD=your_password \ taiga-mcp-server # Using docker-compose docker-compose up --build

{ "mcpServers": { "taiga-mcp": { "command": "npx", "args": ["taiga-mcp-server"], "env": { "TAIGA_API_URL": "https://api.taiga.io/api/v1", "TAIGA_USERNAME": "your_username", "TAIGA_PASSWORD": "your_password" } } } }

{ "mcpServers": { "taiga-mcp": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "TAIGA_API_URL=https://api.taiga.io/api/v1", "-e", "TAIGA_USERNAME=your_username", "-e", "TAIGA_PASSWORD=your_password", "taiga-mcp-server:latest" ] } } }

{ "mcpServers": { "taiga-mcp": { "command": "docker-compose", "args": [ "-f", "/path/to/project/docker-compose.yml", "run", "--rm", "taiga-mcp-server" ], "cwd": "/path/to/project" } } }

{ "env": { "TAIGA_API_URL": "https://your-taiga-domain.com/api/v1", "TAIGA_USERNAME": "your_username", "TAIGA_PASSWORD": "your_password" } }

🗣️ "Show me all sprints in project MyApp" 📊 Returns: List of sprints with status and dates 🗣️ "Get details for Sprint 5" 🔍 Returns: Complete sprint information including: - Basic info (ID, slug, status, order) - Timeline (start/end dates, created/modified dates) - Metrics (total/closed points, user story count) - Team (owner, watchers, available roles) - Description and user stories list - Full JSON data for programmatic access 🗣️ "Get detailed statistics for Sprint 5" 📈 Returns: Progress stats, completion rates, user stories count 🗣️ "Create a new sprint called 'Q1 Release' from 2024-01-01 to 2024-03-31" ✅ Returns: Created sprint details

🗣️ "List all issues in project MyApp" 📋 Returns: Issues with sprint assignments and status 🗣️ "Show me issue #123 details" 🔍 Returns: Complete issue info including sprint, assignee, timeline 🗣️ "Update issue 838 status to 'In Progress'" 🔄 Returns: Issue status updated with confirmation 🗣️ "Assign issue 838 to John Doe" 👤 Returns: Issue assigned to team member with details 🗣️ "Add issue 838 to Sprint 1.0.95" 🏃 Returns: Issue moved to sprint with confirmation 🗣️ "Remove issue 838 from sprint" 🏃 Returns: Issue removed from sprint assignment 🗣️ "What issues are in Sprint 3?" 📋 Returns: All issues assigned to that sprint

🗣️ "Create a high-priority bug issue: 'Login page not working'" 🐛 Returns: Created issue with details 🗣️ "List all user stories in project MyApp" 📝 Returns: User stories with status and assignments 🗣️ "Show me user story #456 details" 🔍 Returns: Complete user story info including project, status, and points 🗣️ "Assign user story 456 to sprint 101" 🏃 Returns: User story assigned to sprint with confirmation 🗣️ "Unassign user story 456 from sprint" 🏃 Returns: User story removed from sprint assignment 🗣️ "Create these 5 issues in batch: Bug1, Bug2, Feature1, Task1, Task2" 🚀 Returns: Batch creation results with individual success/failure status

🗣️ "Batch create these issues in MyApp: - Bug: Login page broken (High priority) - Feature: Add search functionality (Medium priority) - Task: Update documentation (Low priority)" 📊 Returns: Created 3/3 issues successfully with reference numbers 🗣️ "Batch create user stories: - User registration flow (5 points) - Password reset feature (3 points) - Email notifications (2 points)" 📋 Returns: Created 3/3 user stories with story point assignments

🗣️ "Find all high priority bugs assigned to john: status:open AND priority:high AND assignee:john AND type:bug" 📊 Returns: Filtered list of critical bugs needing attention 🗣️ "Show user stories with 5+ points created this week: points:>=5 AND created:this_week ORDER BY points DESC" 📈 Returns: High-value stories with detailed point breakdown 🗣️ "Search for API-related tasks: subject:contains:\"API\" OR description:contains:\"API\" LIMIT 10" 🔍 Returns: All tasks mentioning API with relevance ranking

🗣️ "Add comment to issue #123: 'This needs more testing before deployment'" 💬 Returns: Comment added successfully with timestamp and user info 🗣️ "Show me all comments for user story #456" 📝 Returns: Complete comment history with user names and dates 🗣️ "Edit comment #789 to say 'Updated implementation approach'" ✏️ Returns: Comment updated successfully with new content 🗣️ "Delete comment #321" 🗑️ Returns: Comment removed from the discussion thread

🗣️ "Upload design.pdf to user story #456 with description 'UI mockup v2'" 📎 Returns: File uploaded successfully with size and metadata 🗣️ "Upload screenshot.png to issue #123 in project MyApp" 📸 Returns: Image file attached with automatic MIME type detection 🗣️ "List all attachments for issue #789" 📂 Returns: Complete attachment list with filenames, sizes, and upload dates 🗣️ "Download attachment #123 to /Downloads/documents/" ⬇️ Returns: File downloaded successfully to specified location 🗣️ "Delete attachment #456" 🗑️ Returns: Attachment removed from the project

The system supports two upload methods optimized for different use cases:

Method 1: File Path (Recommended for Claude Desktop)

{ "itemType": "issue", "itemId": 123, "projectIdentifier": "MyApp", "filePath": "design.pdf", "description": "UI mockup v2" }

Method 2: Base64 Data (For programmatic use)

{ "itemType": "issue", "itemId": 123, "projectIdentifier": "MyApp", "fileData": "base64_encoded_file_content", "fileName": "design.pdf", "mimeType": "application/pdf", "description": "UI mockup v2" }

🗣️ "Create epic 'API v2.0 Migration' in project MyApp with description 'Complete API redesign'" 🏛️ Returns: Epic created with ID, color, and project association 🗣️ "List all epics in project MyApp" 📋 Returns: Epic list with progress stats and linked user stories count 🗣️ "Get details for epic #789" 📊 Returns: Epic overview with progress, status, and linked user stories 🗣️ "Link user story #456 to epic #789" 🔗 Returns: Story successfully linked to epic for better organization 🗣️ "Update epic #789 status to 'In Progress' and add tag 'backend'" ✏️ Returns: Epic updated with new status and organizational tags

- 🔥 Zero Setup: Works immediately with npx
- 🧠 AI-Native: Built specifically for conversational project management
- 🔗 Complete Integration: Full Taiga API coverage with 39 tools
- 📊 Rich Data: Detailed progress tracking and statistics
- 🎯 Sprint-Focused: Advanced sprint-issue relationship tracking
- 🛡️ Secure: Environment-based credential management
- 🚀 Batch Operations: Efficient bulk operations for large projects
- 💬 Team Collaboration: Complete comment system for enhanced communication
- 📎 File Management: Dual upload methods (file path/Base64) with Claude Desktop optimization
- 🏛️ Enterprise-Ready: Epic management for large-scale project organization
- 📖 Knowledge Management: Complete Wiki system for project documentation
- 🔍 Advanced Search: SQL-like query syntax for complex data filtering

This project wasinspired bymcpTAIGAbyadriapedralbes. This version represents a substantial rewrite and reimplementation with entirely new architecture, features, and functionality while using the same ISC license terms.

🤖Developed with Claude Code: This entire project was collaboratively developed withClaude Code, demonstrating the power of AI-assisted software development. The architecture, implementation, testing, and documentation were all created through human-AI collaboration.

Complete documentation is available on ourGitHub Wiki📖

- 🇺🇸English- Complete English documentation
- 🇨🇳简体中文- 完整的简体中文文档
- 🇹🇼繁體中文- 完整的繁體中文文件

npm version patch # Create new version git push origin main --tags # Trigger automated publishing

Automated Flow: Tests → NPM Publish → GitHub Packages → Release Creation
Dual Registry Support: Available on both NPM and GitHub Package Registry
Full Documentation: SeeCI/CD Guidefor complete setup

Issues and pull requests are welcome! Please visit ourGitHub repositoryto contribute.

ISC License - This project is licensed under the ISC License, same as the originalmcpTAIGA.

- Original Inspiration:adriapedralbes/mcpTAIGA
- This Implementation: Substantial rewrite bygreddy7574@gmail.comwith AI assistance from Claude Code
- License: ISC License
- Architecture: Entirely new modular design with 33 MCP tools across 11 categories
- Current Version: v1.8.0 - Enterprise Integration Edition with Epic Management

Interact with Asana tasks, projects, workspaces, and comments using the Asana API.