Scrumboy
Self-hosted kanban & project management with shareable boards, voice commands, sticky-notes and MCP support
What is Scrumboy?
Scrumboy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to self-hosted kanban & project management with shareable boards, voice commands, sticky-notes and mcp support
Self-hosted kanban & project management with shareable boards, voice commands, sticky-notes and MCP support
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Self-hosted kanban & project management with shareable board
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx scrumboyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Scrumboy
Scrumboy is a self-hosted kanban and agile project management application written in Go that includes a built-in MCP server endpoint for AI agent integration. Teams can create shareable boards, run sprint cycles, use voice commands, attach sticky notes, and collaborate in real time — while AI agents connect via the MCP JSON-RPC endpoint to create tasks, update boards, and query project status programmatically. It runs as a single binary with Docker Compose support and stores all data in a local SQLite database with no external dependencies required.
Prerequisites
- Docker and Docker Compose (recommended), or Go 1.18+ for source builds
- An MCP-compatible AI client such as Claude for Desktop
- A Scrumboy API token (generated via the web UI or API) for authenticating MCP requests
- Optional: OpenSSL for generating an encryption key if you want 2FA and password reset features
Start Scrumboy with Docker Compose
Clone the repository and start the application using Docker Compose. The server will be accessible at http://localhost:8080 by default.
git clone https://github.com/markrai/scrumboy.git
cd scrumboy
docker compose up --buildCreate an account and first project
Open http://localhost:8080 in your browser, register a new account, and create your first project and kanban board. You will need a project slug to reference the board from MCP calls.
Generate an API token for MCP access
Create a Bearer token for the MCP endpoint. Log in via the web UI, then call the token creation API.
# First, log in to get a session cookie
curl -c cookies.txt -X POST http://localhost:8080/api/login \
-H "Content-Type: application/json" \
-d '{"username":"you","password":"yourpassword"}'
# Then create an API token
curl -b cookies.txt -X POST http://localhost:8080/api/me/tokens \
-H "Content-Type: application/json" \
-H "X-Scrumboy: 1" \
-d '{"name":"claude-mcp"}'Configure Claude Desktop to connect to Scrumboy MCP
Add the Scrumboy MCP endpoint to your claude_desktop_config.json. The server uses HTTP transport with Bearer token authentication.
{
"mcpServers": {
"scrumboy": {
"type": "http",
"url": "http://localhost:8080/mcp/rpc",
"headers": {
"Authorization": "Bearer sb_your_token_here"
}
}
}
}Test the MCP connection
Send a test MCP call directly with curl to verify the token and endpoint are working before configuring your AI client.
curl -X POST http://localhost:8080/mcp/rpc \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sb_your_token_here" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'Scrumboy Examples
Client configuration
Claude Desktop configuration entry for connecting to a locally running Scrumboy instance via the MCP JSON-RPC endpoint.
{
"mcpServers": {
"scrumboy": {
"type": "http",
"url": "http://localhost:8080/mcp/rpc",
"headers": {
"Authorization": "Bearer sb_your_api_token_here",
"Content-Type": "application/json"
}
}
}
}Prompts to try
Prompts to use once Scrumboy MCP is connected to your AI client.
- "Create a new task called 'Fix login bug' in the backend project"
- "List all open tasks in the sprint for project my-project"
- "Move the task 'Update README' to the Done column"
- "What is the current status of the sprint for project my-project?"
- "Create a new project called 'Q3 Roadmap' with a kanban board"Troubleshooting Scrumboy
MCP endpoint returns 401 Unauthorized
Ensure you are passing the Bearer token generated from the /api/me/tokens endpoint. Tokens start with 'sb_'. Session cookies are not valid for the MCP endpoint — you must use a named API token.
Docker Compose build fails or the container exits immediately
Check that Docker and Docker Compose are up to date. Run 'docker compose logs' to see the error. If the DATA_DIR volume path does not exist, create it manually. For ARM-based Macs ensure you are using a compatible Docker image tag.
Authentication features (2FA, password reset) do not work
These features require the SCRUMBOY_ENCRYPTION_KEY environment variable to be set. Generate a 32-byte base64 key with 'openssl rand -base64 32' and add it to your docker-compose.yml or .env file, then restart the container.
Frequently Asked Questions about Scrumboy
What is Scrumboy?
Scrumboy is a Model Context Protocol (MCP) server that self-hosted kanban & project management with shareable boards, voice commands, sticky-notes and mcp support It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Scrumboy?
Follow the installation instructions on the Scrumboy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Scrumboy?
Scrumboy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Scrumboy free to use?
Yes, Scrumboy is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Scrumboy Alternatives — Similar Business Applications Servers
Looking for alternatives to Scrumboy? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Scrumboy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Scrumboy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.