Taskboard

A local, self-hosted project management tool with a Kanban UI, full CLI, and a built-in MCP server that lets AI assistants manage your projects, tickets, and teams directly.

Single binary. SQLite-backed. No Docker, no external database, no runtime dependencies.

Screenshots

Features

• Kanban Board — drag-and-drop ticket management across Todo, In Progress, and Done columns
• Projects — organize work with customizable projects (icons, colors, prefixes)
• Teams — assign tickets to teams
• Tickets — priority levels, due dates, labels, subtasks, dependencies (blocked by)
• Embedded Terminal — run AI coding agents (opencode, Claude Code) directly from the web UI
• CLI — manage everything from the terminal
• MCP Server — 22 tools for AI-native project management via Model Context Protocol
• Self-Hosted — your data stays on your machine in a SQLite database
• Single Binary — one brew install and you're running

Install

Homebrew

brew tap tcarac/taskboard
brew install taskboard

From source

git clone https://github.com/tcarac/taskboard.git
cd taskboard
make build

Requires Go 1.24+ and Node.js 22+.

Usage

Web UI

taskboard start
# => http://localhost:3010

taskboard start --port 8080

CLI

taskboard project create "Auth System" --prefix AUTH --icon "🔐"
taskboard project list

taskboard ticket create --project <ID> --title "Implement login" --priority high
taskboard ticket list --project <ID> --status todo
taskboard ticket move <ID> --status done

taskboard team create "Backend"
taskboard team list

MCP Server (for AI assistants)

taskboard mcp

Claude Code

claude mcp add taskboard -- /path/to/taskboard mcp

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "taskboard": {
      "command": "/path/to/taskboard",
      "args": ["mcp"]
    }
  }
}

Data Hierarchy

Project → Ticket → Subtask
(initiative)  (task)    (step)

• Projects are the top-level grouping (like epics/initiatives). Create one per body of work.
• Tickets are concrete, actionable tasks within a project. Don't create "epic" tickets — use projects.
• Subtasks are checklist steps within a ticket, for breaking work into verifiable pieces.

Available MCP Tools (22)

Example Prompts

Once the MCP is connected, you can talk to your AI assistant in high-level terms and let it figure out the breakdown:

I'm building a SaaS billing system. Set up the project and break the work
into tickets covering Stripe integration, usage metering, invoice generation,
and a customer billing portal. Prioritize accordingly.

I need to ship a password reset flow. Think through what's involved — API
endpoints, email templates, token handling, UI screens, tests — and create
tickets with subtasks for each piece.

Look at my board and figure out what's blocking progress. If anything in
"in progress" has been sitting there without subtasks, break it down into
concrete next steps.

Here's what that looks like — a project and tickets created entirely by an AI assistant via MCP:

Embedded Terminal

The web UI includes a built-in terminal. Click Terminal in the sidebar to open a full PTY shell with color support and a resizable panel. Run opencode, claude, or any command directly from the browser.

The agent shares the same SQLite database via MCP, so tickets it creates show up on your board immediately.

Data Storage

All data is stored in a SQLite database at:

• macOS: ~/Library/Application Support/taskboard/taskboard.db
• Linux: ~/.config/taskboard/taskboard.db

Migrations run automatically on first start.

Custom Database Path

Use --db to point any command at a different database file:

taskboard --db /path/to/other.db start
taskboard --db /path/to/other.db mcp
taskboard --db /path/to/other.db ticket list

Clearing Data

To wipe all projects, tickets, teams, and labels while keeping the schema intact:

taskboard clear        # prompts for confirmation
taskboard clear -f     # skip confirmation

This also respects --db, so you can clear a specific database file:

taskboard --db /tmp/test.db clear -f

Tech Stack

Development

# Run backend (serves API on :3010)
go run ./cmd/taskboard start

# Run frontend dev server (proxies API to :3010)
cd web && npm run dev

# Build everything
make build

# Clean
make clean

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT