Tududi MCP

A Model Context Protocol (MCP) server that integrates Tududi task management with AI-powered development tools.

Overview

Tududi MCP enables AI agents and developers to interact with Tududi tasks, projects, and areas directly from their IDE. Manage your tasks seamlessly while coding, powered by the Model Context Protocol standard.

Features

• Task Management: Create, read, update, and delete tasks
• Project Organization: Manage projects and organize work
• Area Management: Organize tasks by areas
• Search & Filter: Query tasks with flexible filtering
• AI-Ready: Works with AI agents like GitHub Copilot and Augment Code Agent

Installation

Option 1: Docker (Recommended)

# Clone the repository
git clone https://github.com/jerrytunin/tududi-mcp.git
cd tududi-mcp

# Copy environment file
cp .env.example .env
# Edit .env with your Tududi API URL and key

# Build and run with Docker Compose
docker-compose up -d

# Or build Docker image manually
docker build -t tududi-mcp .
docker run -it --env-file .env tududi-mcp

Option 2: Local Installation

# Clone the repository
git clone https://github.com/jerrytunin/tududi-mcp.git
cd tududi-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuration

The MCP server supports two authentication methods:

Option 1: API Key Authentication (Newer Tududi Versions)

Create a .env file:

TUDUDI_API_URL=http://localhost:3000
TUDUDI_API_KEY=your-api-key-here
LOG_LEVEL=info

Option 2: Email/Password Authentication (Older Tududi Versions)

If your Tududi instance doesn’t support API tokens yet, use email/password authentication:

TUDUDI_API_URL=http://localhost:3000
[email protected]
TUDUDI_PASSWORD=your-password
LOG_LEVEL=info

The MCP server will automatically detect which authentication method to use based on the environment variables provided.

Visual Studio Configuration

Add to your .mcp.json:

{
  "mcpServers": {
    "tududi": {
      "command": "node",
      "args": ["path/to/tududi-mcp/dist/server.js"],
      "env": {
        "TUDUDI_API_URL": "http://localhost:3000",
        "TUDUDI_API_KEY": "your-api-key"
      }
    }
  }
}

Docker Usage

Using Docker Compose

# Start the server