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
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.

Links

• Tududi
• Model Context Protocol
• GitHub Repository