Search or browse the local clipboard history. Read-only. Returns up to 'limit' items (default 20, max 100), newest first, each with its numeric ID, type, source app, favorite flag, size, creation time and a one-line summary; pass an ID to get_paste_item for the full content. Omit 'query' to list the most recent items; otherwise every keyword must match as a prefix of a word in the item's searchable text. 'type' and 'tag' narrow the results and can be combined; tag names come from list_tags. An unknown 'type' or 'tag' returns an error rather than an empty list. Use get_clipboard_stats for counts only and add_to_clipboard to create items.

Return the full content and metadata of one clipboard history item by its numeric ID. Read-only. IDs come from search_clipboard results or from add_to_clipboard. Output is plain text: a header (ID, type, source app, favorite flag, size, creation time, whether it came from a remote device) followed by the content: the text of text/html/rtf items, the URL and page title of links, hex and RGBA values of colors, or the file names of file/image items (binary data is not returned). Returns an error if 'id' is missing, not a number, or matches no existing item. Use search_clipboard first when the ID is not known.

Report how much is stored in the local clipboard history. Read-only, no parameters. Returns plain text with the total item count and total size, then the count and size for each type (text, URL, HTML, RTF, image, file, color); sizes are human-readable (e.g. 1.2 MB). Use it for an overview only: use search_clipboard to see the items themselves and list_tags to see tags.

List every tag defined in the local clipboard history. Read-only, no parameters. Tags are user-created labels (e.g. 'Favorite') attached to clipboard items. Returns plain text with the tag count followed by one line per tag, in the user's configured order, showing its numeric ID and name, or 'No tags found.' when there are none. Pass a tag name to the 'tag' parameter of search_clipboard to find the items carrying it. This tool cannot create, rename or delete tags.

Create a new item in the local clipboard history. This only appends to CrossPaste's history: it does not change the system clipboard and the item is not sent to other devices. Every call creates a new item, even for duplicate content, recorded with source 'MCP'. 'type' defaults to 'text'; supported types: text, url, html, rtf, color, file, image. For file/image, 'content' must be the absolute path of an existing file on this machine (images: png, jpg, jpeg, gif, bmp, webp, heic, heif, tiff, svg); the file is referenced by path, not copied. For color, 'content' may be #RGB, #RRGGBB, #RRGGBBAA, rgb(), rgba(), hsl(), hsla() or a CSS color name. html must contain extractable text and rtf must start with '{\rtf'. On success returns the new item's ID (usable with get_paste_item); on invalid input returns an error and nothing is stored.