Get the user that owns the API key making the request. Useful for verifying authentication and discovering the caller's user id.

List users in the workspace. Optionally filter by emails, status, or membership type. Supports pagination.

List all teams in the workspace. Supports pagination.

Get a single team by its id.

List spaces in the workspace. Spaces are top-level containers that hold boards. Use expand=["board"] to include full board objects.

Get a single space by its id.

List the boards contained in a given space. Supports pagination.

Get a single board by id, including its structure: groups, field/column definitions and their configurations (status labels, tag labels, etc.). Read this before creating or updating items so you know the available field keys/titles and allowed values.

List items (rows) on a board, with optional filtering. Supports pagination; the response includes a hasMore flag indicating whether more pages exist.

Get a single item by id, including its field values.

List the subitems nested under a given item. Supports pagination.

Create a new item (row) on a board, or a subitem when parentId is set. Place it in a group via groupId or groupTitle (defaults to the first group). Set initial field values via fields: an object keyed by field key (e.g. "status-1") or field title (e.g. "Status"). Value formats by field type — String/RichText: "text"; Number: 13.4; Date: "2026-01-02T18:10:15.254Z"; Timeline: {start, end}; Status: "To do" or label id "1"; Tag: ["Product","HR"] or ids; Link: "https://..." or {url, displayText}; Person: {users:[{id}|{email}], teams:[{id}|{title}]}. Call plaky_get_board first to discover available fields and allowed values.

Permanently delete an item (and its subitems) by id. This cannot be undone.

Change the value of one field on an item, identified by the field key or title (itemFieldKey). The value format depends on the field type — String/RichText: "text"; Number: 13.4; Date: "2026-01-02T18:10:15.254Z"; Timeline: {start, end}; Status: "To do" or "1"; Tag: ["Product","HR"]; Link: "https://..." or {url, displayText}; Person: {users:[{id}|{email}], teams:[{id}|{title}]}.

Change several field values on an item in one request. fields is an object keyed by field key or title, with values following the same per-type formats as plaky_create_item (e.g. {"Status":"Done", "number-1":42}).

List all comments on an item, including replies and reaction details.

Add a comment to an item. Set repliesToId to post the comment as a reply to an existing comment.

Edit the text of an existing comment.

Permanently delete a comment by id.

Set the authenticated user's reactions on a comment. This OVERRIDES any existing reactions by the caller; pass an empty array to remove all of them. Each reaction is an emoji's unicode codepoint without the "U+" prefix (case-insensitive) — e.g. "1f44d" (thumbs up), "2705" (check mark), "2764" (heart).

List the files attached to an item.

Get metadata for a single file attached to an item.

Upload a local file and attach it to an item. Provide the absolute path to a file on the machine running this MCP server.

Rename a file or change its description. The original file extension/type is preserved regardless of the name given.

Permanently delete a file attached to an item.

Download a file attached to an item. If the API returns JSON (e.g. a presigned download URL) that is returned directly. If it returns binary content, provide savePath to write it to disk; the tool then returns the saved path and size. Binary content is never streamed into the conversation.