# Plaky MCP by usefulapi

> Plaky MCP by usefulapi is an MCP server. Read boards and items, create items, set field values and add comments in Plaky. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/plaky/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/plaky
- **MCP Registry name:** io.usefulapi/plaky
- **Listing updated:** 2026-11-13

## About

Read boards and items, create items, set field values and add comments in Plaky.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http plaky https://plaky.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://plaky.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "plaky": {
      "url": "https://plaky.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "plaky": {
      "type": "http",
      "url": "https://plaky.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "plaky": {
      "serverUrl": "https://plaky.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "plaky": {
      "type": "http",
      "url": "https://plaky.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `plaky_get_current_user`: Return the owner of the API key: id, name, email, role (OWNER/ADMIN/MEMBER/VIEWER) and status. Good first call to verify the key works. Plaky API: GET /v1/public/users/me.
- `plaky_list_users`: List workspace users, optionally filtered by email, status (ACTIVE/PENDING/INACTIVE) or role (OWNER/ADMIN/MEMBER/VIEWER). Plaky API: GET /v1/public/users.
- `plaky_list_teams`: List workspace teams. Use the team ids when you subscribe teams to items. Plaky API: GET /v1/public/teams.
- `plaky_get_team`: Get one team by id, with its members. Plaky API: GET /v1/public/teams/{teamId}.
- `plaky_list_spaces`: List spaces in the workspace. Pass expand=['board'] to include each space's boards. Plaky API: GET /v1/public/spaces.
- `plaky_get_space`: Get one space by id. Pass expand=['board'] to include its boards. Plaky API: GET /v1/public/spaces/{spaceId}.
- `plaky_list_boards`: List the boards in one space. Plaky API: GET /v1/public/spaces/{spaceId}/boards.
- `plaky_get_board`: Get one board: its fields (keys, titles, types, allowed values) and groups. Call it first to learn the field keys before you set values. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}.
- `plaky_list_item_groups`: List the item groups (sections) of a board. Use their ids for plaky_create_item and plaky_move_item_to_group. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/item-groups.
- `plaky_list_items`: List items on a board, optionally in one board view or under one parent item. subitems_behaviour: INCLUDE (default), EXCLUDE or EMBED. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items.
- `plaky_get_item`: Get one item with its field values, group and subitem count. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}.
- `plaky_list_subitems`: List the subitems of one item. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/sub-items.
- `plaky_list_item_comments`: List the comments on one item, with replies and reactions. Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/comments.
- `plaky_list_item_files`: List the files attached to one item (name, size, type, uploader). Plaky API: GET /v1/public/spaces/{spaceId}/boards/{boardId}/items/{itemId}/files.
- `plaky_get_item_file_download_url`: Return a short-lived presigned download URL for one item file (see expiresInSeconds). The file bytes are not returned. Plaky API: GET .../files/{itemFileId}/download.
- `plaky_create_item`: Create an item on a board, or a subitem when parent_id is set. Fields map a field key or title to a value. Writes data: creates a new item on each call. Plaky API: POST /v1/public/spaces/{spaceId}/boards/{boardId}/items.
- `plaky_update_item_field`: Set the value of one field on an item. The field is a key ('status-1') or a title ('Status'). Setting the same value again changes nothing. Plaky API: PATCH .../items/{itemId}/fields/{itemFieldKey}.
- `plaky_move_item_to_group`: Move an item to another item group on the same board. The item is added to the end of the target group. Plaky API: PATCH .../items/{itemId}/group.
- `plaky_add_item_comment`: Add a comment to an item, or a reply when reply_to_comment_id is set. Writes data: each call posts a new comment. Plaky API: POST .../items/{itemId}/comments.
- `plaky_set_comment_reactions`: Set the emoji reactions the API key's user leaves on one comment. Replaces the current reactions; an empty list removes them. Emoji codes are hex, e.g. '1f44d' (thumbs up). Plaky API: PUT .../comments/{itemCommentId}/reactions.

## FAQ

### How do I add Plaky MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http plaky https://plaky.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/plaky-mcp-by-usefulapi
