taiga-mcp

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

Register with Claude Code:

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 | | 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