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 taskstududi_create_task- Create a new tasktududi_update_task- Update an existing tasktududi_delete_task- Delete a tasktududi_complete_task- Mark a task as completetududi_list_projects- List all projectstududi_create_project- Create a new projecttududi_list_areas- List all areastududi_search_tasks- Search tasks with filters
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE for details.