Full-featured MCP server for Taiga project management with advanced sprint and issue tracking. Based on mcpTAIGA by adriapedralbes, enhanced with substantial modifications. Developed collaboratively with Claude Code (AI-assisted development).
npm install taiga-mcp-serverA powerful Model Context Protocol (MCP) server that enables natural language interaction with Taiga project management systems. Seamlessly manage your projects, sprints, user stories, tasks, and issues through conversational AI.
> ๐ค AI-Powered Development: This project was developed collaboratively with Claude Code (claude.ai/code), showcasing the potential of AI-assisted software development.
field:operator:value syntax for precise searches``bashNPM Registry (official)
npx taiga-mcp-server
$3
bash
From NPM Registry
npm install -g taiga-mcp-server
taiga-mcpFrom GitHub Packages
npm install -g @greddy7574/taiga-mcp-server
`$3
bash
Build the image
docker build -t taiga-mcp-server .Run with environment file
docker run --rm -i --env-file .env taiga-mcp-serverOr 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-serverUsing docker-compose
docker-compose up --build
`โ๏ธ Configuration
$3
#### NPX Method (Recommended)
Add to your Claude Desktop
:`json
{
"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"
}
}
}
}
`#### Docker Method
json
{
"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"
]
}
}
}
`#### Docker Compose Method
json
{
"mcpServers": {
"taiga-mcp": {
"command": "docker-compose",
"args": [
"-f", "/path/to/project/docker-compose.yml",
"run", "--rm", "taiga-mcp-server"
],
"cwd": "/path/to/project"
}
}
}
`$3
For self-hosted Taiga instances:json
{
"env": {
"TAIGA_API_URL": "https://your-taiga-domain.com/api/v1",
"TAIGA_USERNAME": "your_username",
"TAIGA_PASSWORD": "your_password"
}
}
`๐ฏ Usage Examples
$3
๐ฃ๏ธ "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
$3
๐ฃ๏ธ "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
$3
๐ฃ๏ธ "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
$3
๐ฃ๏ธ "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
$3
๐ฃ๏ธ "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
$3
๐ฃ๏ธ "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
$3
๐ฃ๏ธ "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
$3
The system supports two upload methods optimized for different use cases:Method 1: File Path (Recommended for Claude Desktop)
json
{
"itemType": "issue",
"itemId": 123,
"projectIdentifier": "MyApp",
"filePath": "design.pdf",
"description": "UI mockup v2"
}
`Method 2: Base64 Data (For programmatic use)
json
{
"itemType": "issue",
"itemId": 123,
"projectIdentifier": "MyApp",
"fileData": "base64_encoded_file_content",
"fileName": "design.pdf",
"mimeType": "application/pdf",
"description": "UI mockup v2"
}
`$3
๐ฃ๏ธ "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
$3
๐ฃ๏ธ "Create wiki page 'api-documentation' in project MyApp with content about API usage"
๐ Returns: Wiki page created with slug, project association, and content preview๐ฃ๏ธ "List all wiki pages in project MyApp"
๐ Returns: Complete wiki page list with modification dates and content summaries
๐ฃ๏ธ "Get wiki page 'user-guide' details from project MyApp"
๐ Returns: Full wiki content, metadata, watchers, and version information
๐ฃ๏ธ "Update wiki page 'installation-guide' with new Docker instructions"
โ๏ธ Returns: Wiki page updated with new content and incremented version
๐ฃ๏ธ "Watch wiki page 'api-documentation' for change notifications"
๐๏ธ Returns: Successfully subscribed to wiki page change notifications
๐ฃ๏ธ "Delete wiki page 'outdated-info' from project MyApp"
๐๏ธ Returns: Wiki page permanently deleted with confirmation details
๐ง Available Tools (42 Total)
$3
| Tool | Description |
|------|-------------|
| | Authenticate with Taiga API |$3
| Tool | Description |
|------|-------------|
| listProjects | Get all accessible projects |
| getProject | View detailed project information |$3
| Tool | Description |
|------|-------------|
| listMilestones | List all sprints in a project |
| getMilestone | Get complete sprint details including user stories, watchers, owner, timeline, metrics, and full JSON data |
| getMilestoneStats | Get sprint progress and statistics |
| createMilestone | Create new sprints with dates |
| getIssuesByMilestone | View all issues in a sprint |$3
| Tool | Description |
|------|-------------|
| listIssues | List issues with sprint info |
| getIssue | Get detailed issue information |
| createIssue | Create issues with priorities/types |
| updateIssueStatus | Update issue status (e.g., "In Progress", "Done") |
| addIssueToSprint | Assign issues to sprints or remove from sprints |
| assignIssue | Assign issues to team members or unassign |$3
| Tool | Description |
|------|-------------|
| listUserStories | View user stories in a project |
| getUserStory | Get detailed user story information |
| createUserStory | Create new user stories |
| assignUserStoryToSprint | Assign a user story to a sprint or unassign it |$3
| Tool | Description |
|------|-------------|
| createTask | Create tasks linked to user stories |$3
| Tool | Description |
|------|-------------|
| batchCreateIssues | Batch create multiple issues (up to 20) |
| batchCreateUserStories | Batch create multiple user stories |
| batchCreateTasks | Batch create multiple tasks for a user story |$3
| Tool | Description |
|------|-------------|
| advancedSearch | Execute advanced SQL-like queries |
| queryHelp | Get query syntax help and examples |
| validateQuery | Validate query syntax before execution |$3
| Tool | Description |
|------|-------------|
| addComment | Add comments to issues, stories, or tasks |
| listComments | View comment history for items |
| editComment | Edit existing comments |
| deleteComment | Delete comments |$3
| Tool | Description | Key Features |
|------|-------------|--------------|
| uploadAttachment | Upload files to issues, stories, or tasks | Dual method support (file path/Base64), smart path resolution |
| listAttachments | View attachment list for items | Complete metadata with file sizes and upload dates |
| downloadAttachment | Download attachments by ID | Flexible download path management |
| deleteAttachment | Delete attachments | Safe deletion with confirmation |$3
| Tool | Description |
|------|-------------|
| createEpic | Create large-scale Epic features |
| listEpics | List all Epics in a project |
| getEpic | Get Epic details and progress stats |
| updateEpic | Update Epic information and status |
| linkStoryToEpic | Link User Stories to Epics |
| unlinkStoryFromEpic | Remove Story-Epic associations |$3
| Tool | Description |
|------|-------------|
| createWikiPage | Create project Wiki pages with Markdown support |
| listWikiPages | List all Wiki pages in a project |
| getWikiPage | Get Wiki page details by ID or slug |
| updateWikiPage | Update Wiki page content and settings |
| deleteWikiPage | Delete Wiki pages (irreversible) |
| watchWikiPage | Watch/unwatch Wiki pages for notifications |๐ Why Choose Taiga MCP Server?
- ๐ฅ 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
๐ Acknowledgments
$3
This project was inspired by mcpTAIGA by adriapedralbes. This version represents a substantial rewrite and reimplementation with entirely new architecture, features, and functionality while using the same ISC license terms.$3
๐ค Developed with Claude Code: This entire project was collaboratively developed with Claude Code, demonstrating the power of AI-assisted software development. The architecture, implementation, testing, and documentation were all created through human-AI collaboration.$3
From the original basic concept, this version expanded to include:- Complete Architectural Redesign: Professional modular tool system (v1.5.0+)
- 33 MCP Tools: From basic functionality to enterprise-grade project management
- Advanced Sprint Management: Complete milestone tracking with detailed statistics
- Enhanced Issue Management: Full issue lifecycle with sprint associations
- Batch Operations: Efficient bulk creation for large-scale projects (v1.6.0)
- Advanced Query System: SQL-like syntax for complex data filtering (v1.6.1)
- Team Collaboration: Complete comment system for enhanced communication (v1.7.0)
- File Management: Full attachment lifecycle with multi-format support (v1.7.1)
- Epic Management: Enterprise-grade large-scale project organization (v1.8.0)
- Professional Code Quality: Error handling, formatting, comprehensive testing
- Comprehensive Documentation: Professional guides and examples in 3 languages
- Automated CI/CD: Dual registry publishing with complete automation
Original concept: Basic Taiga MCP connectivity
This implementation: Full-featured Taiga project management suite with entirely new architecture
This reimplementation acknowledges the foundational concept while showcasing the collaborative potential of AI-assisted software development.
๐ Documentation
Complete documentation is available on our GitHub Wiki ๐
$3
Our documentation is available in three languages:
- ๐บ๐ธ English - Complete English documentation
- ๐จ๐ณ ็ฎไฝไธญๆ - ๅฎๆด็็ฎไฝไธญๆๆๆกฃ
- ๐น๐ผ ็น้ซไธญๆ - ๅฎๆด็็น้ซไธญๆๆไปถ
$3
| Section | English | ็ฎไฝไธญๆ | ็น้ซไธญๆ |
|---------|---------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
| Getting Started | Installation Guide | ๅฎ่ฃ
ๆๅ | ๅฎ่ฃๆๅ |
| API Reference | API Reference | API ๅ่ | API ๅ่ |
| Architecture | Architecture | ๆถๆๆฆ่ง | ๆถๆงๆฆ่ฆฝ |
| CI/CD Guide | CI/CD Guide | CI/CD ๆๅ | CI/CD ๆๅ |
$3
| Topic | English | ็ฎไฝไธญๆ | ็น้ซไธญๆ |
|-------|-------------------------------------------------------------------------------------|----------------------------------------------------------------------------|----------------------------------------------------------------------------|
| Design Document | Design | ่ฎพ่ฎกๆๆกฃ | ่จญ่จๆไปถ |
| First Steps | First Steps | ็ฌฌไธๆญฅ | ็ฌฌไธๆญฅ |
| Configuration | Configuration | ้
็ฝฎ่ฏดๆ | ่จญๅฎ่ชชๆ |
> ๐ก Tip: The Wiki provides better search, navigation, and mobile experience!
๐ Automated Publishing
This project features a fully automated CI/CD pipeline:
`bash
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: See CI/CD Guide for complete setup
Issues and pull requests are welcome! Please visit our GitHub repository to contribute.
ISC License - This project is licensed under the ISC License, same as the original mcpTAIGA.
---
Enhanced with โค๏ธ for agile teams using Taiga project management