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
TUDUDI_EMAIL=your-email@example.com
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
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the server
docker-compose down

Using Docker Directly

# Build the image
docker build -t tududi-mcp .

# Run the container
docker run -it \
  -e TUDUDI_API_URL=http://localhost:3000 \
  -e TUDUDI_API_KEY=your-api-key \
  -e LOG_LEVEL=info \
  tududi-mcp

# Run in background
docker run -d --name tududi-mcp \
  -e TUDUDI_API_URL=http://localhost:3000 \
  -e TUDUDI_API_KEY=your-api-key \
  tududi-mcp

Development

npm install
npm run build
npm run dev
npm test

Available Tools

tududi_list_tasks - List all tasks
tududi_create_task - Create a new task
tududi_update_task - Update an existing task
tududi_delete_task - Delete a task
tududi_complete_task - Mark a task as complete
tududi_list_projects - List all projects
tududi_create_project - Create a new project
tududi_list_areas - List all areas
tududi_search_tasks - Search tasks with filters

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

tududi-mcp