snboard-mcp

MCP (Model Context Protocol) server for Kanban board management via REST API.

Installation

npm install snboard-mcp
# or
npx snboard-mcp

Configuration

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "kanban": {
      "command": "npx",
      "args": ["snboard-mcp@latest"],
      "env": {
        "KANBAN_BASE_URL": "https://katool.epheria.fr",
        "KANBAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

| Variable | Description | Required | | ----------------- | -------------------------- | ------------------------- | | KANBAN_BASE_URL | Base URL of the Kanban API | Yes | | KANBAN_API_KEY | API key for authentication | Yes (if API is protected) |

Available Tools

Folders

• list_folders - List all folders with their projects
• create_folder - Create a new folder
• update_folder - Update a folder
• delete_folder - Delete a folder
• move_project_to_folder - Move a project to a folder

Projects

• list_projects - List all projects
• create_project - Create a new project
• get_project - Get a project with its boards
• update_project - Update a project
• delete_project - Delete a project

Boards

• list_boards - List boards for a project
• create_board - Create a new board
• get_board - Get a board with columns and cards
• update_board - Update a board
• delete_board - Delete a board

Columns

• create_column - Create a column
• update_column - Update a column
• delete_column - Delete a column

Cards

• create_card - Create a card
• update_card - Update a card
• delete_card - Delete a card
• move_card - Move a card to a different column
• add_comment - Add a comment to a card
• get_branch_name - Generate a GitHub branch name for a card
• search_cards - Search cards

Tags

• list_tags - List all tags
• create_tag - Create a tag
• delete_tag - Delete a tag
• add_tag_to_card - Add a tag to a card
• remove_tag_from_card - Remove a tag from a card

Epics

• list_epics - List all epics
• create_epic - Create an epic
• get_epic - Get an epic with its cards
• update_epic - Update an epic
• delete_epic - Delete an epic
• add_card_to_epic - Add a card to an epic
• remove_card_from_epic - Remove a card from an epic
• get_epic_timeline - Get epic timeline

Card Links

• link_cards - Link two cards
• unlink_cards - Unlink two cards
• get_linked_cards - Get linked cards
• get_feature_cards - Get feature bundle

GitHub Integration

• setup_github_integration - Setup GitHub webhook
• get_github_integration - Get GitHub settings
• update_github_integration - Update GitHub settings
• remove_github_integration - Remove GitHub integration
• link_card_to_branch - Link card to branch
• link_card_to_pr - Link card to PR
• github_list_repos - List user's GitHub repos
• github_create_branch - Create a GitHub branch
• github_create_pr - Create a GitHub PR
• github_auto_setup_webhook - Auto-setup webhook

Development

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

Publishing

# Build and publish to GitHub Packages
pnpm build
npm publish

License

MIT