Taiga MCP Bridge

You can connect Taiga project management resources to the Model Context Protocol (MCP) to automate creation, querying, and management of Taiga artifacts through AI tools. This bridge enables you to work with projects, epics, user stories, tasks, issues, and sprints in a programmatic, context-aware way within your MCP-enabled workflows.

How to use

To use this MCP server, configure an MCP client to connect via a local stdio transport that starts the Taiga MCP Bridge as a subprocess. The bridge exposes a set of tools you can call to manage Taiga resources, run queries, and perform actions such as creating projects, epics, and user stories. You can control response verbosity to balance detail against context usage.

How to install

Prerequisites: ensure Python 3.10 or higher is installed on your system. Install the uv package manager to run the server locally.

Step-by-step setup:

# Clone the repository
git clone https://github.com/your-org/pyTaigaMCP.git
cd pyTaigaMCP

# Install dependencies
./install.sh

Additional sections

Configuration and runtime security are handled through a small set of environment variables. You can place these in a .env file at the project root or export them in your shell.

Environment variables used by the Taiga MCP Bridge:

• TAIGA_API_URL: Base URL for the Taiga API
• TAIGA_USERNAME: Taiga username for auto-authentication
• TAIGA_PASSWORD: Taiga password for auto-authentication
• TAIGA_TRANSPORT: Transport mode (stdio or sse)

Startup command and example environment are shown below to run the bridge locally in stdio mode. The example demonstrates starting the server with the required credentials and transport settings.

# Example environment and startup (stdio)
TAIGA_API_URL=https://api.taiga.io/api/v1/
TAIGA_USERNAME=your_username
TAIGA_PASSWORD=your_password
TAIGA_TRANSPORT=stdio

uv run python src/server.py

Available tools

login

Authenticate and establish a session with Taiga using provided credentials. Returns a session_id for subsequent calls.

list_projects

Retrieve a list of Taiga projects accessible with the current session or auto-authenticated context.

list_user_stories

Query user stories within a specified project, with optional verbosity controls.

create_project

Create a new Taiga project with a given name and description.

create_epic

Create an epic within a specified project to group related user stories.

create_user_story

Create a new user story in a project, optionally linked to an epic.

logout

Terminate the current authenticated session.

session_status

Check the validity and remaining time of the active session.