Skip to main content
Glama

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

Related MCP server: planning-task-mcp

Installation

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

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

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

Custom Attributes

Tool

Description

list_custom_attributes

List custom attribute definitions for a project (task, user story, issue, or epic)

get_custom_attributes_values

Read current custom attribute values of a task/US/issue/epic, joined with their definitions

update_custom_attribute_value

Set a single custom attribute value, by attribute name or ID

Attachments

Tool

Description

list_attachments

List attachments on an issue, US, task, epic, or wiki page

upload_attachment

Attach a local file to 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

Available Tools

55 tools
add_commentB

Add a comment to a Taiga issue, user story, task, or epic

Inputs: object_type (required), object_id (required), version (required), comment (required).

bulk_create_userstoriesB

Create multiple user stories at once from a list of subjects (one per line)

Inputs: project_id (required), subjects (required), status_id, milestone_id.

create_epicB

Create a new epic in a Taiga project

Inputs: project_id (required), subject (required), description, color, +2 more.

create_issueC

Create a new issue in a Taiga project

Inputs: project_id (required), subject (required), description, priority, +4 more.

create_milestoneB

Create a new sprint/milestone in a Taiga project

Inputs: project_id (required), name (required), estimated_start (required), estimated_finish (required), +2 more.

create_projectC

Create a new Taiga project

Inputs: name (required), description, is_private, is_backlog_activated, +3 more.

create_roleB

Create a new role in a Taiga project

Inputs: project_id (required), name (required), order, computable, +1 more.

create_taskB

Create a new task in a Taiga project

Inputs: project_id (required), subject (required), description, userstory_id, +3 more.

create_userstoryB

Create a new user story in a Taiga project

Inputs: project_id (required), subject (required), description, milestone_id, +3 more.

create_wiki_pageC

Create a new wiki page in a Taiga project

Inputs: project_id (required), slug (required), content (required).

delete_epicA

Permanently delete a epic. This action cannot be undone.

Inputs: epic_id (required).

delete_issueA

Permanently delete a issue. This action cannot be undone.

Inputs: issue_id (required).

delete_milestoneA

Permanently delete a milestone. This action cannot be undone.

Inputs: milestone_id (required).

delete_roleA

Delete a role from a project. Cannot be undone.

Inputs: role_id (required).

delete_taskA

Permanently delete a task. This action cannot be undone.

Inputs: task_id (required).

delete_userstoryA

Permanently delete a user story. This action cannot be undone.

Inputs: userstory_id (required).

delete_wiki_pageB

Delete a wiki page permanently

Inputs: wiki_id (required).

get_epicB

Get details of a specific epic by ID

Inputs: epic_id (required).

get_historyA

Get the activity history and comments of a Taiga issue, user story, task, or epic

Inputs: object_type (required), object_id (required).

get_issueB

Get a specific issue by ID

Inputs: issue_id (required).

get_meA

Get the currently authenticated Taiga user

Inputs: no named parameters.

get_milestoneB

Get details of a specific sprint/milestone

Inputs: milestone_id (required).

get_milestone_statsA

Get progress statistics for a sprint/milestone (points done, remaining, burndown data)

Inputs: milestone_id (required).

get_projectA

Get details of a specific Taiga project by ID or slug

Inputs: project_id (required).

get_roleA

Get details of a specific role including its permissions

Inputs: role_id (required).

get_userstoryB

Get a specific user story by ID

Inputs: userstory_id (required).

get_wiki_pageB

Get the full content of a wiki page by ID

Inputs: wiki_id (required).

list_epicsB

List all epics in a Taiga project

Inputs: project_id (required).

list_epic_userstoriesB

List all user stories linked to an epic

Inputs: epic_id (required).

list_issuesC

List issues in a Taiga project

Inputs: project_id (required), status, assigned_to.

list_issue_statusesA

List all issue statuses for a project (use these IDs when updating issue status)

Inputs: project_id (required).

list_issue_typesA

List all issue types for a project (use these IDs when creating/updating issues)

Inputs: project_id (required).

list_membersA

List all members of a Taiga project with their user IDs (needed for assigning issues/tasks)

Inputs: project_id (required).

list_milestonesB

List sprints/milestones in a Taiga project

Inputs: project_id (required), closed.

list_prioritiesA

List all issue priorities for a project (use these IDs when creating/updating issues)

Inputs: project_id (required).

list_projectsA

List all Taiga projects the authenticated user has access to

Inputs: no named parameters.

list_rolesA

List all roles defined in a Taiga project (needed for assigning story points per role)

Inputs: project_id (required).

list_severitiesA

List all issue severities for a project (use these IDs when creating/updating issues)

Inputs: project_id (required).

list_tagsA

List all tags used in a Taiga project with their colors

Inputs: project_id (required).

list_tasksC

List tasks in a Taiga project, optionally filtered by user story or milestone

Inputs: project_id (required), userstory_id, milestone_id, assigned_to.

list_task_statusesA

List all task statuses for a project (use these IDs when updating task status)

Inputs: project_id (required).

list_userstoriesA

List user stories in a Taiga project, optionally filtered by milestone

Inputs: project_id (required), milestone_id, status.

list_userstory_statusesA

List all user story statuses for a project (use these IDs when updating user story status)

Inputs: project_id (required).

list_wiki_pagesB

List all wiki pages in a Taiga project

Inputs: project_id (required).

update_epicB

Update an existing epic (subject, description, status, assignee, color)

Inputs: epic_id (required), version (required), subject, description, +4 more.

update_issueC

Update an existing issue (status, assignee, description, etc.)

Inputs: issue_id (required), version (required), subject, description, +5 more.

update_milestoneA

Update an existing sprint/milestone (name, dates, availability, close it)

Inputs: milestone_id (required), name, estimated_start, estimated_finish, +2 more.

update_projectB

Update a Taiga project's settings (name, description, visibility, etc.)

Inputs: project_id (required), name, description, is_private, +4 more.

update_roleB

Update an existing role (name, order, permissions, computability)

Inputs: role_id (required), name, order, computable, +1 more.

update_taskC

Update an existing task (status, assignee, description, etc.)

Inputs: task_id (required), version (required), subject, description, +3 more.

update_userstoryC

Update an existing user story

Inputs: userstory_id (required), version (required), subject, description, +4 more.

update_wiki_pageC

Update the content of an existing wiki page

Inputs: wiki_id (required), version (required), content (required), slug.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 55 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action. There is no overlap; for example, create_epic, create_issue, create_userstory are clearly separate. Even similar tools like list_issue_statuses vs list_issue_types serve different purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case. Verbs like create, delete, get, list, update, add, bulk_create, link, unlink, search are used uniformly. No mixing of conventions.

    Tool Count4/5

    With 55 tools, the server is comprehensive but on the high side. The count is justified by covering many entities (epics, issues, tasks, user stories, milestones, wiki pages, roles, projects) and supplementary operations (list statuses, types, priorities, etc.), but could be slightly trimmed.

    Completeness4/5

    The tool set provides full CRUD for most entities and includes extras like linking, bulk creation, search, and activity history. Notable gaps: no get_task tool (though create, update, delete, list exist) and no comment CRUD beyond add_comment.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Full-featured MCP server for Taiga project management, enabling AI agents to manage projects, epics, user stories, tasks, issues, sprints, wiki pages, memberships, and roles via Taiga API v1.
      100
      39 npm
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Full autonomous project management MCP server enabling AI assistants to manage projects, sprints, tasks, bugs, proposals, and team collaboration via natural language.
      10 npm
      MIT
    • F
      license
      C
      quality
      D
      maintenance
      MCP server for the Zube.io project management API, exposing boards, cards, epics, tickets, sprints, and workspaces as tools for AI assistants.
      42
      -
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Taiga project management, enabling LLM clients to inspect and manage projects, work items, sprints, comments, attachments, and wiki pages via 6 op-dispatching tools.
      6
      20 npm
      3
      MIT