MCP CopyQ Server

Read from CopyQ clipboard manager.

MCP tabs (full read/write access):

• mcp/info - general information storage

• mcp/заметки - notes storage

• mcp/workspace - projects (supports subtabs like workspace/myproject)

External tabs (READ-ONLY access with scope="all" or scope="external"):

• All other CopyQ tabs like "&clipboard", personal tabs, etc.

• Use scope="all" to see all tabs, scope="external" for non-mcp only

Modes:

• tree: Get tab structure with previews. Use FIRST to see available tabs.

• list: Get items from tab with pagination

• item: Get single item with full content (text, tags, note)

• search: Search by regex across tabs

Parameters:

• mode (required): "tree" | "list" | "item" | "search"

• tab: For mcp tabs use relative path "info", "workspace/proj1". For external use full name "&clipboard"

• scope: "mcp" (default) | "all" | "external" - controls which tabs are accessible

• index: Item index (for mode=item)

• query: Search regex (for mode=search)

Examples:

• tree of mcp tabs: mode="tree"

• tree of ALL tabs: mode="tree", scope="all"

• read external tab: mode="list", tab="&clipboard", scope="external"

• search everywhere: mode="search", query="pattern", scope="all"

Errors: TAB_NOT_FOUND, INDEX_OUT_OF_BOUNDS, INVALID_MODE

Write to CopyQ clipboard manager.

IMPORTANT: All data stored under "mcp/" prefix. When you use tab="info", actual CopyQ path is "mcp/info".

Available tabs:

• info - general storage (use tab="info")

• заметки - notes (use tab="заметки")

• workspace - projects, supports subtabs (use tab="workspace" or "workspace/myproject")

Modes:

• add: Add item to tab. Params: tab, text, tags (optional), note (optional)

• update: Update item. Params: tab, index, field, text/tags/note

• delete: Delete item. Params: tab, index

• move: Move item. Params: tab, index, to_tab

• tab_create: Create subtab in workspace only. Params: path (e.g. "workspace/newproject")

• tab_delete: Delete subtab. Params: path

Response shows full_path (e.g. "mcp/info") confirming where data was written.

Errors: TAB_NOT_FOUND, INDEX_OUT_OF_BOUNDS, PERMISSION_DENIED, MISSING_PARAM

Validate parameters for mcp_read or mcp_write without executing.

Use to check if a call will succeed before making it.

Parameters:

• tool (required): "read" | "write"

• params (required): Parameters object to validate

Returns:

• valid: true/false

• errors: List of error codes and messages

• warnings: List of warnings

• estimated_tokens: Estimated response token count