Tools

3 tools for reading, writing, and inspecting the system clipboard:

clipboard_read

Read the current clipboard contents in a requested format.

• auto mode returns the richest format explicitly present — priority: image > html > rtf > text
• image returns base64-encoded PNG data with pixel dimensions
• html returns raw HTML source as copied from a browser
• rtf returns raw RTF markup
• text returns plain text
• Size limits: 512 KB for text/HTML/RTF, 5 MB for images (raw bytes before base64 expansion)
• Returns a typed format_unavailable error when the requested format is not on the clipboard — use clipboard_inspect first to check availability

clipboard_write

Write content to the clipboard, replacing current contents.

• text writes plain text
• html writes HTML with an auto-generated plain-text fallback (tag-stripped), so paste targets that only accept plain text still receive something useful
• Size limit: 1 MB
• destructiveHint: true — replaces whatever is currently on the clipboard

clipboard_inspect

List the formats and byte sizes of what is currently on the clipboard without reading the full content.

• Returns primaryFormat — the richest format present (image > html > rtf > text), or empty
• Returns availableFormats — all semantic formats present, for deciding which format to pass to clipboard_read
• Returns rawTypes — all raw platform type identifiers with byte sizes (UTIs on macOS, TARGETS on X11/Wayland, format names on Windows)
• Use this before clipboard_read to avoid format_unavailable errors and to check content size b

... View full README on GitHub