Plaky

A Model Context Protocol server that exposes the Plaky project-management REST API to MCP-compatible AI clients (Claude Desktop, Claude Code, Cursor, etc.).

It wraps the full Plaky public API surface — spaces, boards, items/subitems, fields, comments, reactions, files, users and teams — as 26 well-described tools.

Features

• Workspace — current user, list/get users (filter by email/status/type), list/get teams
• Spaces & boards — list/get spaces, list boards, get board structure (groups, fields, allowed values)
• Items — list (with view/parent/expand filters + pagination), get, create item or subitem, delete
• Fields — update one field or many at once, by field key or title, with per-type value formats
• Comments — list, create (incl. replies), update, delete, and set emoji reactions
• Files — list, get, upload (from a local path), rename/describe, delete, download
• Clean error reporting (status + API error body), 429 rate-limit awareness, 1-indexed pagination with hasMore.

Install

npm install plaky-mcp

Or run without installing globally:

npx plaky-mcp

You need a Plaky API key (Plaky → Profile settings → API). It is sent as the X-API-Key header on every request.

Client configuration

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json)

{
  "mcpServers": {
    "plaky": {
      "command": "npx",
      "args": ["-y", "plaky-mcp"],
      "env": {
        "PLAKY_API_KEY": "your-api-key"
      }
    }
  }
}

For Claude Code you can also run:

claude mcp add plaky --env PLAKY_API_KEY=your-api-key -- npx -y plaky-mcp

Cursor

Add to your MCP settings (.cursor/mcp.json or Cursor Settings → MCP):

{
  "mcpServers": {
    "plaky": {
      "command": "npx",
      "args": ["-y", "plaky-mcp"],
      "env": {
        "PLAKY_API_KEY": "your-api-key"
      }
    }
  }
}

Development

git clone https://github.com/pavlealeksic/plaky-mcp.git
cd plaky-mcp
npm install
npm run build
export PLAKY_API_KEY="your-api-key"
npm start

Environment variables

Tool reference

All tools are prefixed plaky_. IDs are integers. Typical flow: plaky_list_spaces → plaky_list_boards → plaky_get_board (to learn field keys and allowed values) → plaky_list_items / plaky_create_item / plaky_update_item_fields.

Field value formats

When setting fields (on create/update), keys are field keys ("status-1") or titles ("Status"). Values by type:

npm run dev    # tsx watch on src/index.ts
npm run build  # tsc -> dist/

Notes

• Rate limit: 200 requests / user / minute; exceeding it returns HTTP 429.

License

MIT