Taiga MCP Server
Full-featured MCP (Model Context Protocol) server for Taiga project management. Provides comprehensive access to Taiga's API v1, enabling AI agents to manage projects, epics, user stories, tasks, issues, sprints, wiki pages, memberships, roles, and more.
Features
Covers all Taiga API v1 endpoints:
- Projects โ CRUD, stats, tags, likes, watching
- Epics โ CRUD, bulk create, related user stories, voting, watching, attachments
- User Stories โ CRUD, bulk operations, ordering, voting, watching, attachments
- Tasks โ CRUD, bulk create, voting, watching, attachments
- Issues โ CRUD, bulk create, voting, watching, attachments
- Milestones/Sprints โ CRUD, stats, watching
- Wiki โ Pages & links CRUD, watching, attachments
- Memberships โ CRUD, bulk invite
- Roles โ CRUD with permissions
- Users โ List, get, me, stats, contacts
- Statuses โ US/Task/Issue statuses, types, priorities, severities, points
- Custom Attributes โ Definitions & values for epics, user stories, tasks, issues
- History & Comments โ Change history, create/delete comments
- Search โ Global project search
- Timeline โ User & project timeline
- Resolver โ Slug/ref to ID resolution
- Webhooks โ CRUD, test, logs
- Export/Import โ Project export & import
Setup
Environment Variables
MCP Client Configuration (recommended)
The easiest way to use this server is via npx โ no installation required:
{
"mcpServers": {
"taiga": {
"command": "npx",
"args": ["-y", "@illodev/taiga-mcp"],
"env": {
"TAIGA_URL": "https://taiga.example.com",
"TAIGA_USERNAME": "your-user",
"TAIGA_PASSWORD": "your-pass"
}
}
}
}
VS Code / GitHub Copilot โ add the entry above to your
mcp.json.
Claude Desktop โ add it undermcpServersinclaude_desktop_config.json.
Docker Compose
cp .env.example .env
# Edit .env with your Taiga credentials
docker compose up --build
Local Development
pnpm install
pnpm run dev
Build
pnpm run build
pnpm start
Agent Customizations
This project includes ready-to-use GitHub Copilot customizations under .github/ so your AI agents can work effectively with the Taiga MCP tools.
.github/
โโโ agents/ # Custom agents (10)
โ โโโ taiga-project-manager.agent.md # Orchestrator โ delegates to sub-agents
โ โโโ taiga-user-stories.agent.md # User story CRUD, backlog, story points
โ โโโ taiga-tasks.agent.md # Task CRUD, statuses, comments
โ โโโ taiga-issues.agent.md # Bug triage & issue classification
โ โโโ taiga-epics.agent.md # Epic CRUD, story-to-epic linking
โ โโโ taiga-sprints.agent.md # Sprint lifecycle & burndown
โ โโโ taiga-wiki.agent.md # Wiki pages, links, history
โ โโโ taiga-team.agent.md # Members, roles, permissions
โ โโโ taiga-reporter.agent.md # Project reports & analytics (read-only)
โ โโโ taiga-project-setup.agent.md # Project config, webhooks, export/import
โโโ instructions/ # Context-aware guidelines
โ โโโ taiga-mcp-usage.instructions.md # Tool naming, ID resolution, common patterns
โ โโโ taiga-workflows.instructions.md # Scrum/Kanban recipes, feature flows
โ โโโ taiga-orchestration.instructions.md # Agent delegation & coordination
โโโ skills/ # On-demand workflow skills
โโโ sprint-planning/SKILL.md # Create & manage sprints
โโโ backlog-grooming/SKILL.md # Refine stories, epics, and points
โโโ issue-triage/SKILL.md # Classify and prioritize issues
โโโ project-setup/SKILL.md # Configure a new project from scratch
โโโ project-reporting/SKILL.md # Generate stats and reports
โโโ team-management/SKILL.md # Manage members, roles, permissions
โโโ wiki-documentation/SKILL.md # Create and organize wiki pages
Custom Agents
Skills (slash commands)
Expanded Documentation
For detailed guides and examples, see the docs/ folder:
- Getting Started โ Installation, configuration, and first steps
- Agent Architecture โ Hub-and-spoke delegation, agent roles, and chaining
- Usage Examples โ Practical examples for every agent domain
- Advanced Workflows โ Multi-domain recipes: feature dev, sprint planning, bug lifecycle, project bootstrap
Instructions
Loaded automatically when relevant:
- taiga-mcp-usage โ Tool naming conventions, ID resolution patterns, error handling
- taiga-workflows โ Ready-made recipes for Scrum sprints, Kanban boards, feature development, bug resolution
- taiga-orchestration โ Agent delegation patterns and multi-domain workflow coordination