Planka MCP Server

A Model Context Protocol (MCP) server for interacting with Planka, a kanban-style project management tool.

Features

• List Projects: Get a list of all accessible projects.
• List Boards: List boards within a project.
• List Columns: List columns (lists) on a board.
• List Cards: List cards in a column or on a board.
• Move Card: Move a card to a different column or position.
• Add Comment: Add a comment to a card.
• List Comments: Retrieve comments for a card.

Installation

Prerequisites

• Python 3.10+
• A Planka instance and a personal access token.

Setup

1. Clone the repository:

   git clone https://git.danilkolesnikov.ru/Flash/planka-mcp.git
   cd planka-mcp
   

2. Create a virtual environment and install dependencies:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

3. Configure environment variables: Create a .env file or export the following:

   export PLANKA_URL="https://your-planka-instance.com"
   export PLANKA_TOKEN="your-access-token"
   

Usage

You can run the server directly or via an MCP client (like OpenClaw or Claude Desktop).

Command Line

python3 server.py list_projects

MCP Configuration (OpenClaw)

Add the following to your openclaw.json or equivalent configuration:

{
  "planka": {
    "command": "/path/to/venv/bin/python3",
    "args": ["/path/to/server.py"],
    "env": {
      "PLANKA_URL": "...",
      "PLANKA_TOKEN": "..."
    }
  }
}

Development

Run tests:

pytest test_server.py test_planka_logic.py

License

MIT