Taiga MCP Server

An MCP (Model Context Protocol) server that allows you to interact with Taiga using natural language via Claude or other MCP-compatible AI assistants. This server enables you to list your projects, create user stories, add tasks, and more.

Features

• Authenticate with Taiga
• List all your Taiga projects
• Get detailed information about a specific project
• Create user stories within a project
• List user stories in a project
• Create tasks within user stories
• Interact with Taiga using natural language through Claude

Prerequisites

• Node.js (v16 or higher)
• npm
• A Taiga account

Installation

Using npx (recommended)

The easiest way to use the Taiga MCP server is directly with npx:

npx taigamcp

This will download and run the latest version of the server.

From npm

You can also install the package globally:

npm install -g taigamcp

Then run it:

taigamcp

From source

1. Clone this repository:

   git clone <repository-url>
   cd mcpTAIGA

2. Install dependencies:

   npm install

3. Run the server:

   npm start

Configuration

Create a .env file with your Taiga credentials:

TAIGA_API_URL=https://api.taiga.io/api/v1
TAIGA_USERNAME=your_username
TAIGA_PASSWORD=your_password

You can also pass these credentials directly when using the authenticate tool.

Claude Desktop Configuration

To add this server to Claude Desktop, update your claude_desktop_config.json with:

"taiga-mcp": {
  "command": "npx",
  "args": ["-y", "taigamcp"]
}

For WSL users:

"taiga-mcp": {
  "command": "wsl.exe",
  "args": [
    "bash",
    "-c",
    "/usr/bin/npx -y taigamcp"
  ]
}

Available Tools

The server provides the following tools:

1. authenticate - Authenticate with Taiga
2. listProjects - List all your Taiga projects
3. getProject - Get detailed information about a specific project
4. createUserStory - Create a new user story in a project
5. listUserStories - List all user stories in a project
6. createTask - Create a new task within a user story

Example Prompts for Claude

Here are some example natural language prompts you can use with Claude:

• "Authenticate with Taiga using my credentials"
• "List all my Taiga projects"
• "Show me details about project X"
• "Create a new user story in project Y with title 'Implement login feature'"
• "Show me all user stories in project Z"
• "Add a task to user story #123 with the title 'Create API endpoint'"

Testing

For direct testing without Claude, you can use the included test clients:

node testClient.js

or

node testDirectClient.js

License

ISC