Kanboard MCP

🚀 Kanboard MCP Server

A powerful Go-based MCP server that enables seamless integration between AI assistants (like Claude Desktop, Cursor) and the Kanboard project management system. Manage your Kanboard projects, tasks, users, and workflows directly through natural language commands.

⚠️ Important Note

To avoid issues like these:

We recommend using mcpproxy as a proxy solution.

🚀 Quick Start

Prerequisites

• Go 1.21 or higher
• A Kanboard instance with API access
• An MCP-compatible client (e.g., Cursor, Claude Desktop)

Installation

1. Clone the repository:

   git clone https://github.com/bivex/kanboard-mcp.git
   cd kanboard-mcp
   

2. Build the executable:
   • On Windows:

     build-release.bat
     

   • On Linux/macOS:

     ./build-release.sh
     

   • Manual build:

     go build -ldflags="-s -w" -o kanboard-mcp .
     

✨ Features

• 🔗 Seamless Kanboard Integration - Communicate directly with the Kanboard API.
• 🤖 Natural Language Processing - Use plain English to manage your projects.
• 📊 Complete Project Management - Handle projects, tasks, users, columns, and more.
• 🔐 Secure Authentication - Support both API key and username/password authentication.
• ⚡ High Performance - Built with Go for optimal performance.
• 🎯 MCP Standard - Compatible with all MCP clients.

📦 Installation

The installation steps are covered in the "Quick Start" section above.

💻 Usage Examples

Basic Usage

# Project Workflow
# Create a new project
"Create a new project called 'Mobile App Development'"

# Add tasks to the project
"Create task 'Design UI mockups' in project 'Mobile App Development'"
"Create task 'Set up development environment' in project 'Mobile App Development'"

# Get all tasks
"Get tasks for 'Mobile App Development' project"

# Move tasks between columns
"Move task 1 to 'In Progress' column"
"Move task 2 to 'Done' column"

# Team Management
# Create a new team member
"Create user 'alice.smith' with password 'secure123' and email 'alice@company.com'"

# Assign user to project
"Assign user 'alice.smith' to project 'Mobile App Development' as project - member"

# Assign tasks to team members
"Assign task 1 to user 'alice.smith'"

# Task Organization
# Create categories for better organization
"Create category 'Critical Bugs'"
"Create category 'Feature Requests'"

# Add comments to tasks
"Add comment 'This needs urgent attention' to task 5"

# Set deadlines
"Set due date for task 3 to 2024-01-20"

📚 Documentation

⚙️ Configuration

1. Environment Variables

Set up your Kanboard credentials using environment variables:

export KANBOARD_API_ENDPOINT="https://your-kanboard-url/jsonrpc.php"
export KANBOARD_API_KEY="your-kanboard-api-key"
export KANBOARD_USERNAME="your-kanboard-username"
export KANBOARD_PASSWORD="your-kanboard-password"

2. MCP Client Configuration

Create the MCP configuration file for your client:

• Location (Windows): C:\Users\YOUR_USERNAME\AppData\Roaming\Cursor\.cursor\mcp_config.json
• Location (Linux/macOS): ~/.cursor/mcp_config.json

{
  "mcpServers": {
    "kanboard-mcp-server": {
      "command": "/path/to/your/kanboard-mcp",
      "args": [],
      "env": {
        "KANBOARD_API_ENDPOINT": "https://your-kanboard-url/jsonrpc.php",
        "KANBOARD_API_KEY": "your-kanboard-api-key",
        "KANBOARD_USERNAME": "your-kanboard-username",
        "KANBOARD_PASSWORD": "your-kanboard-password"
      }
    }
  }
}

3. Restart Your Client

After saving the configuration, restart your MCP client (e.g., Cursor, Claude Desktop) for changes to take effect.

🛠️ Available Tools

📁 Project Management

And many other tool sections... (omitted here for brevity, but follow the same structure as above)

🔧 Technical Details

Building from Source

# Clone the repository
git clone https://github.com/bivex/kanboard-mcp.git
cd kanboard-mcp

# Install dependencies
go mod download

# Build the application
go build -o kanboard-mcp .

# Run tests
go test ./...

Project Structure

kanboard-mcp/
├── main.go              # Main application entry point
├── go.mod               # Go module dependencies
├── go.sum               # Dependency checksums
├── build-release.bat    # Windows build script
├── build-release.sh     # Unix build script
├── README.md            # This file
└── LICENSE.md           # License information

Contributing

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE.md file for details.