home / mcp / tududi mcp server

Tududi MCP Server

Model Context Protocol server for Tududi task management - enables AI agents to interact with Tududi

Installation

Add the following to your MCP client configuration file.

Configuration

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

Tududi MCP provides a Model Context Protocol server that connects Tududi task management with AI-powered development tools. You can manage tasks, projects, and areas from your IDE or AI agents, enabling seamless collaboration between coding and task tracking.

How to use

Use an MCP client to connect to Tududi MCP and start issuing task-related actions through natural language prompts or structured queries. You can list, create, update, and delete tasks; manage projects and areas; and search tasks with filters. The server is designed to work smoothly with AI agents and developer tools, so you can integrate Tududi task management into your development workflow and keep tasks aligned with code changes.

How to install

Prerequisites: You need Node.js and npm installed on your system. You can also run Tududi MCP via Docker if you prefer containerized deployment.

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

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. Use the environment variables below to configure authentication for Tududi access.

# API Key Authentication (Newer Tududi Versions)
TUDUDI_API_URL=http://localhost:3000
TUDUDI_API_KEY=your-api-key-here
LOG_LEVEL=info

If API tokens are not available, you can use Email/Password Authentication (Older Tududi Versions). This method is autodetected based on the provided environment variables.

# Email/Password Authentication (Older Tududi Versions)
TUDUDI_API_URL=http://localhost:3000
[email protected]
TUDUDI_PASSWORD=your-password
LOG_LEVEL=info

Development

You can develop and test locally by installing dependencies, building the project, and running the development server or tests.

npm install
npm run build
npm run dev
npm test

Available tools

tududi_list_tasks

List all tasks in Tududi including filters and pagination options where supported.

tududi_create_task

Create a new Tududi task with title, description, and metadata.

tududi_update_task

Update properties of an existing Tududi task such as status, assignee, or due date.

tududi_delete_task

Delete a Tududi task by its identifier.

tududi_complete_task

Mark a Tududi task as complete.

tududi_list_projects

List all Tududi projects.

tududi_create_project

Create a new Tududi project.

tududi_list_areas

List all Tududi areas for organizing tasks.

tududi_search_tasks

Search tasks with flexible filters to find relevant work.