taiga-mcp

MCP server for the Taiga project management API. Lets AI assistants (Claude, etc.) manage projects, issues, user stories, tasks, epics, sprints, wiki pages, and more through natural language.

Requirements

Node.js 18+
A running Taiga instance (cloud or self-hosted)
Claude Code, Claude Desktop, or any MCP-compatible client

Installation

Option A — from source (recommended)

git clone https://github.com/juanleon8581/taiga-mcp
cd taiga-mcp
npm install && npm run build

claude mcp add taiga -s user \
  -e TAIGA_URL=https://your-taiga-instance.com \
  -e TAIGA_USERNAME=your_username \
  -e TAIGA_PASSWORD=your_password \
  -- node /absolute/path/to/taiga-mcp/dist/index.js

Option B — Claude Desktop

Clone and build as above, then add to claude_desktop_config.json:

{
  "mcpServers": {
    "taiga": {
      "command": "node",
      "args": ["/absolute/path/to/taiga-mcp/dist/index.js"],
      "env": {
        "TAIGA_URL": "https://your-taiga-instance.com",
        "TAIGA_USERNAME": "your_username",
        "TAIGA_PASSWORD": "your_password"
      }
    }
  }
}

Environment variables

Variable	Required	Description
`TAIGA_URL`	Yes	Base URL of your Taiga instance (no trailing slash)
`TAIGA_USERNAME`	Yes	Taiga username or email
`TAIGA_PASSWORD`	Yes	Taiga password

Authentication

On startup the server logs in with your credentials and stores the JWT access token in memory. On token expiry (401), it automatically refreshes using the refresh token. If the refresh token also expires, it re-logs in with your credentials. Credentials are never sent more than necessary.

Available tools

Projects

Tool	Description
`list_projects`	List all accessible projects
`get_project`	Get project details by ID or slug
`create_project`	Create a new project
`update_project`	Update project settings (name, description, visibility, etc.)

Issues

Tool	Description
`list_issues`	List issues with optional filters
`get_issue`	Get issue details
`create_issue`	Create a new issue
`update_issue`	Update status, assignee, description, etc.

User Stories

Tool	Description
`list_userstories`	List user stories, filter by sprint
`get_userstory`	Get user story details
`create_userstory`	Create a user story
`update_userstory`	Update a user story
`bulk_create_userstories`	Create multiple user stories at once

Tasks

Tool	Description
`list_tasks`	List tasks, filter by US or sprint
`get_task`	Get task details, including full description
`create_task`	Create a task
`update_task`	Update a task
`move_task`	Move a task to a different user story (or unassign it)

Milestones / Sprints

Tool	Description
`list_milestones`	List sprints
`get_milestone`	Get sprint details
`create_milestone`	Create a new sprint/milestone
`update_milestone`	Update sprint name, dates, or close it
`get_milestone_stats`	Burndown and progress stats

Epics

Tool	Description
`list_epics`	List epics
`get_epic`	Get epic details
`create_epic`	Create an epic
`update_epic`	Update an epic
`list_epic_userstories`	List user stories linked to an epic
`link_userstory_to_epic`	Link a user story to an epic
`unlink_userstory_from_epic`	Remove the link

Roles

Tool	Description
`list_roles`	List all roles in a project (needed for story points)
`get_role`	Get role details including permissions
`create_role`	Create a new role in a project
`update_role`	Update role name, order, or permissions
`delete_role`	Delete a role from a project

Members & Lookups

Tool	Description
`get_me`	Get the authenticated user
`list_members`	List project members with user IDs
`add_member`	Add a user to a project by email (role defaults to first project role)
`list_issue_statuses`	Issue status IDs for a project
`list_userstory_statuses`	User story status IDs
`list_task_statuses`	Task status IDs
`list_priorities`	Priority IDs
`list_severities`	Severity IDs
`list_issue_types`	Issue type IDs
`list_tags`	Tags with colors

Comments & History

Tool	Description
`add_comment`	Add a comment to any object
`get_history`	Get activity history and comments

Search

Tool	Description
`search`	Full-text search across issues, US, tasks, wiki, epics

Wiki

Tool	Description
`list_wiki_pages`	List wiki pages
`get_wiki_page`	Get page content
`create_wiki_page`	Create a wiki page
`update_wiki_page`	Update a wiki page
`delete_wiki_page`	Delete a wiki page

Attachments

Tool	Description
`list_attachments`	List attachments on an issue, US, task, epic, or wiki page
`download_attachment`	Download an attachment's file to local disk

Delete

Tool	Description
`delete_issue`	Delete an issue permanently
`delete_userstory`	Delete a user story permanently
`delete_task`	Delete a task permanently
`delete_epic`	Delete an epic permanently
`delete_milestone`	Delete a milestone permanently

Verify connection

claude mcp list
# taiga: node ... - ✔ Connected

Update

cd taiga-mcp
git pull
npm install && npm run build

License

MIT