Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Taiga MCP Server Show me the user stories in the 'Website Redesign' project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP (Model Context Protocol) server to integrate Taiga with Claude and other LLM clients.
Manage projects, sprints, user stories, tasks, issues, epics, and wiki directly from your assistant.
Node.js >= 20
Access to a Taiga instance (cloud or self-hosted)
Taiga authentication token
Related MCP server: Taiga MCP Server
cd taiga
npm install
npm run buildcurl -s -X POST https://<your-instance>/api/v1/auth \
-H "Content-Type: application/json" \
-d '{"type":"normal","username":"<username>","password":"<password>"}' \
| grep auth_tokenVariable | Description | Example |
| Base URL of your Taiga instance |
|
| Authentication token obtained in the previous step |
|
| Logging verbosity (default: |
|
~/.config/Claude/claude_desktop_config.json){
"mcpServers": {
"taiga": {
"command": "node",
"args": ["/absolute/path/to/taiga/dist/index.js"],
"env": {
"TAIGA_URL": "https://<your-instance>",
"TAIGA_AUTH_TOKEN": "<your-token>"
}
}
}
}.claude/settings.json){
"mcpServers": {
"taiga": {
"command": "node",
"args": ["/absolute/path/to/taiga/dist/index.js"],
"env": {
"TAIGA_URL": "https://taiga.mycompany.com",
"TAIGA_AUTH_TOKEN": "your-token-here"
}
}
}
}Tool | Description |
| List all projects |
| Project detail by ID or slug |
| Create a new project |
| List members of a project |
Tool | Description |
| List sprints of a project |
| Sprint detail |
| Create a sprint |
Tool | Description |
| List user stories with filters |
| User story detail |
| Create a user story |
| Edit a user story (requires |
| Delete a user story |
Tool | Description |
| List tasks with filters |
| Task detail |
| Create a task |
| Edit a task (requires |
| Delete a task |
Tool | Description |
| List issues with filters |
| Issue detail |
| Create an issue |
| Edit an issue (requires |
| Delete an issue |
Tool | Description |
| List epics of a project |
| Epic detail |
| Create an epic |
| Edit an epic (requires |
Tool | Description |
| List wiki pages of a project |
| Get a wiki page by ID or slug |
| Create a wiki page |
| Edit a wiki page (requires |
| Global search within a project |
npm run dev # Watch mode compilation
npm run build # Production build
npm start # Start the compiled serverSee SPECS.md for detailed tool specifications.
See DECISIONS.md for the design decisions log.
src/
├── index.ts # Entry point and MCP server configuration
├── types.ts # TypeScript interfaces for all Taiga entities
├── formats.ts # Formatting functions for readable responses
├── logger.ts # Structured logger (DEBUG/INFO/WARN/ERROR), configurable via LOG_LEVEL
├── errors.ts # TaigaApiError class with HTTP status differentiation
├── services/
│ └── taiga.ts # HTTP client and Taiga API functions
└── tools/ # One file per entity, each registers its MCP tools
├── projects.ts
├── milestones.ts
├── userstories.ts
├── tasks.ts
├── issues.ts
├── epics.ts
└── wiki-search.tsCreate a new epic in a project
Inputs: subject (required), project_id (required), tags, color, +3 more.
Create a new issue in a project
Inputs: subject (required), project_id (required), tags, type, +6 more.
Create a new sprint in a project
Inputs: name (required), project_id (required), estimated_start (required), estimated_finish (required).
Create a new project in Taiga
Inputs: name (required), is_private, description.
Create a new task in a project
Inputs: subject (required), project_id (required), tags, status, +4 more.
Create a new user story in a project
Inputs: subject (required), project_id (required), tags, status, +3 more.
Create a new wiki page in a project
Inputs: slug (required), content (required), project_id (required).
Permanently delete an issue
Inputs: issue_id (required).
Permanently delete a task
Inputs: task_id (required).
Permanently delete a user story
Inputs: userstory_id (required).
Edit an existing epic. Fetch the current version with taiga_get_epic before editing.
Inputs: epic_id (required), version (required), tags, color, +4 more.
Edit an existing issue. Fetch the current version with taiga_get_issue before editing.
Inputs: version (required), issue_id (required), tags, type, +7 more.
Edit an existing task. Fetch the current version with taiga_get_task before editing.
Inputs: task_id (required), version (required), tags, status, +5 more.
Edit an existing user story. Fetch the current version with taiga_get_userstory before editing.
Inputs: version (required), userstory_id (required), tags, status, +4 more.
Edit the content of a wiki page. Fetch the current version with taiga_get_wiki_page before editing.
Inputs: content (required), page_id (required), version (required).
Get full details of an epic by ID
Inputs: epic_id (required).
Get full details of an issue by ID
Inputs: issue_id (required).
Get details of a sprint by ID, including its user stories
Inputs: milestone_id (required).
Get details of a project by ID or slug
Inputs: slug, project_id.
Get full details of a task by ID
Inputs: task_id (required).
Get full details of a user story by ID
Inputs: userstory_id (required).
Get a wiki page by ID, or by project + slug
Inputs: slug, page_id, project_id.
List all epics in a project
Inputs: project_id (required), page, page_size.
List issues with optional filters
Inputs: page, type, status, priority, +5 more.
List the members of a project
Inputs: project_id (required).
List sprints in a project
Inputs: project_id (required), page, closed, page_size.
List all accessible Taiga projects
Inputs: page, page_size.
List tasks with optional filters
Inputs: page, status, page_size, project_id, +3 more.
List user stories with optional filters
Inputs: page, tags, status, page_size, +3 more.
List all wiki pages in a project
Inputs: project_id (required), page, page_size.
Full-text search across a project (searches epics, user stories, issues, tasks, and wiki)
Inputs: text (required), project_id (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 31 tools
Each tool targets a distinct resource-action pair (e.g., list_issues vs. get_issue vs. create_issue), and resource types are clearly separated. The only cross-resource tool is taiga_search, which is explicitly described as full-text search, so no ambiguity exists.
All tools follow a consistent 'taiga_<verb>_<resource>' pattern with standard verbs (list, get, create, edit, delete). Plural nouns are used for list operations and singular for others, making the naming scheme highly predictable.
With 31 tools, the server far exceeds the typical well-scoped range (3-15) and even the 'heavy' range (16-25). While each tool has a clear purpose, the large number feels excessive for a single server, especially given incomplete CRUD coverage across resource types.
User stories, tasks, and issues have full CRUD operations, but projects, milestones, epics, and wiki pages lack delete operations, and projects and milestones also lack edit operations. These are notable gaps in lifecycle coverage that agents cannot fully work around.
Sprints, stories, tasks, issues, epics, wiki and attached files in Taiga; writes only when allowed.
Laviya project management: read and update tasks, wikis, sprints and test cases.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Open your team's project from the AI you use: read and write its brief, documents, tasks and notes.
