Skip to content
MCP server

Plaky MCP by usefulapi

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

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About Plaky MCP by usefulapi

Plaky MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://plaky.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "plaky": {
      "url": "https://plaky.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (20)

Read directly from the server.

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.

Plaky MCP by usefulapi 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