bivex/kanboard-mcp

> **Model Context Protocol (MCP) Server for Kanboard Integration**
A powerful Go-based MCP server that enables seamless integration between AI assistants (like Claude Desktop, Cursor) and Kanboard project management system. Manage your Kanboard projects, tasks, users, and workflows directly through natural language commands.
⚠️ **Warning:** To avoid issues like these:
We recommend using mcpproxy as a proxy solution.
📋 Table of Contents
- ✨ Features
- 🚀 Quick Start
- ⚙️ Configuration
- 🛠️ Available Tools
- 📖 Usage Examples
- 🔧 Development
- 📄 License
✨ Features
- 🔗 **Seamless Kanboard Integration** - Direct API communication with Kanboard
- 🤖 **Natural Language Processing** - Use plain English to manage your projects
- 📊 **Complete Project Management** - Handle projects, tasks, users, columns, and more
- 🔐 **Secure Authentication** - Support for both API key and username/password auth
- ⚡ **High Performance** - Built with Go for optimal performance
- 🎯 **MCP Standard** - Compatible with all MCP clients
🚀 Quick Start
Prerequisites
- Go 1.21 or higher
- Kanboard instance with API access
- MCP-compatible client (Cursor, Claude Desktop, etc.)
Installation
1. **Clone the repository:**
2. **Build the executable:**
**On Windows:**
**On Linux/macOS:**
**Manual build:**
⚙️ Configuration
1. Environment Variables
Set up your Kanboard credentials and RBAC permissions using environment variables:
Required Credentials:
RBAC Configuration (Optional):
Configure user roles for proper access control. If not set, the system will try to get roles from Kanboard API, falling back to app-user role.
**Available Application Roles:**
- app-admin - Full system administrator access
- app-manager - Can create projects and manage users
- app-user - Basic user access (default)
**Available Project Roles:**
- project-manager - Full project management access
- project-member - Can create/modify tasks and comments
- project-viewer - Read-only access to project
**🔐 Authentication Methods:**
Kanboard supports different authentication methods via KANBOARD_AUTH_METHOD:
- **global_token** (default): Uses global API token with jsonrpc: format
- **user_token**: Uses user-specific API token with : format
- **bearer**: Uses Bearer token authentication
**🔧 Troubleshooting RBAC Issues:**
If you're getting "access denied" errors:
1. **Check your user role in Kanboard:**
- Go to Kanboard web interface
- Check your user profile/role settings
- Ensure you have appropriate permissions
2. **Enable debug logging:**
This will show your current roles and permission checks in the console.
3. **Temporarily skip RBAC for testing:**
⚠️ **Warning:** Only use for debugging! Disables all permission checks.
4. **Manually set roles via environment:**
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
- **Linux/macOS:** ~/.cursor/mcp_config.json
**Configuration:**
3. Restart Your Client
After saving the configuration, restart your MCP client (Cursor, Claude Desktop, etc.) for changes to take effect.
🛠️ Available Tools
📁 Project Management
| Tool | Description | Example |
|------|-------------|---------|
| get_projects | 📋 List all projects | "Show me all Kanboard projects" |
| create_project | ➕ Create new projects | "Create a project called 'Website Redesign' with description 'Redesign the company website' and owner 1" |
| get_project_by_id | 🔍 Get project information by ID | "Get project details for ID 123" |
| get_project_by_name | 🔍 Get project information by name | "Get project details for name 'My Project'" |
| get_project_by_identifier | 🔍 Get project information by identifier | "Get project details for identifier 'WEB-APP'" |
| get_project_by_email | 🔍 Get project information by email | "Get project details for email 'project@example.com'" |
| get_all_projects | 📋 Get all available projects | "Show me all available projects" |
| update_project | ✏️ Update a project | "Update project 1 with new name 'New Website' and description 'Updated description'" |
| remove_project | 🗑️ Remove a project | "Remove project with ID 456" |
| enable_project | ✅ Enable a project | "Enable project 123" |
| disable_project | 🚫 Disable a project | "Disable project 123" |
| enable_project_public_access | 🌐 Enable public access for a given project | "Enable public access for project 123" |
| disable_project_public_access | 🔒 Disable public access for a given project | "Disable public access for project 123" |