Yokan

You will run and connect to the YokAn Kanban Board MCP server to manage boards, columns, and tasks through AI agents. This MCP server exposes programmatic endpoints and a local stdio interface so you can integrate it with tools like Gemini or VS Code Copilot, enabling automated board management via the Master Control Protocol.

How to use

You can connect using an MCP client configured for either the HTTP transport or the stdio transport. The HTTP transport talks to a running MCP server over your network, while the stdio transport runs a local MCP process that you interact with directly through standard input/output.

How to install

Prerequisites: you should have Python installed (Python 3.8+), a container engine if you plan to run Docker, and access to a running YokAn API instance.

Install with Docker (recommended for quick start):

# Build the Docker image
docker build -t yokanboard/yokan-mcp .

# Run the Docker container
docker run -p 8888:8888 --name yokan-mcp -e YOKAN_API_BASE_URL=http://your-yokan-api-host:port/api yokanboard/yokan-mcp

Additional sections

Configuration details include MCP server connection settings for both HTTP and stdio transports. Use the following examples to configure your MCP clients.

{
  "mcpServers": {
    "yokan-board": {
      "type": "http",
      "url": "http://[your-yokan-mcp-host]:8888/mcp",
      "headers": {
        "Authorization": "Bearer [TOKEN]",
        "accept": "application/json"
      },
      "args": []
    }
  }
}

{
  "servers": {
    "yokan-board": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/full/path/to/yokan-board-mcp-project-folder/yokan-board-mcp",
        "-m",
        "src.main",
        "--stdio"
      ]
    }
  }
}

Available tools

get_boards

Retrieve a list of Kanban boards available in the YokAn system.

get_board

Fetch details for a single board by its identifier.

create_board

Create a new Kanban board with initial configuration.

update_board

Modify properties of an existing board.

delete_board

Remove a board from the YokAn system.

create_column

Add a new column to a board.

get_columns

List all columns within a board.

update_column

Update properties of a specific column.

reorder_columns

Change the order of columns within a board.

delete_column

Delete a column from a board.

update_column_color

Set or change the color of a column for visual distinction.

create_task

Create a new task within a column.

create_tasks

Create multiple tasks in a batch operation.

get_tasks

List tasks within a board or column.

update_task

Update task details such as title, description, or status.

move_task

Move a task between columns or adjust its position.

delete_task

Delete a task from the board.