Clipboard History Mcp
by d-khomenkocommunityv0.5.0-alpha.0
19
A Rust-based macOS/Linux clipboard history MCP server that captures clipboard items, classifies them (URL, JSON, code, SQL, secrets), indexes them in SQLite FTS5, and lets Claude search, list, restore, tag, pin, delete, and unlock encrypted secrets. It can optionally mirror non-secret clips into an Obsidian vault and uses Touch ID / Secret Service-backed encryption for secret values.
From the registry: Your clipboard, but Claude can read it. Type-classified, secret-encrypted. macOS + Linux.
Install & configure
Prerequisites
- optionalDownload the packaged binary bundle (.mcpb)Download the latest release bundle, then extract it to access the server binary for manual/CLI configuration.
https://github.com/d-khomenko/clipboard-history-mcp/releases/latest/download/clipboard-history-mcp.mcpb},{$ curl -L https://github.com/d-khomenko/clipboard-history-mcp/releases/latest/download/clipboard-history-mcp.mcpb -o clipboard-history-mcp.mcpb && unzip clipboard-history-mcp.mcpb -d ext
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `clipboard-history-mcp` MCP server into my current AI client (that's you).
Optional prerequisites:
- Download the packaged binary bundle (.mcpb) — Download the latest release bundle, then extract it to access the server binary for manual/CLI configuration. Run: `curl -L https://github.com/d-khomenko/clipboard-history-mcp/releases/latest/download/clipboard-history-mcp.mcpb -o clipboard-history-mcp.mcpb && unzip clipboard-history-mcp.mcpb -d ext` (https://github.com/d-khomenko/clipboard-history-mcp/releases/latest/download/clipboard-history-mcp.mcpb},{)
Canonical MCP server config (stdio transport):
- command: `./ext/server/clipboard-history-mcp`
- args: ["serve"]
- optional environment variables:
- `CLIPBOARD_POLL_MS`: Watcher poll interval in milliseconds. (example: `<poll-interval-ms>`)
- `CLIPBOARD_HISTORY_MAX`: Maximum clipboard history ring-buffer size. (example: `<history-size>`)
- `CLIPBOARD_CAPTURE_WINDOW_TITLE`: Set to 1 to capture window titles. On macOS this needs Accessibility permission; on Linux this is currently X11-only. (example: `<0-or-1>`)
- `CLIPBOARD_IGNORE_APPS`: Comma-separated app display names to skip when capturing clipboard events. (example: `<app1,app2>`)
- `CLIPBOARD_NEVER_STORE_SECRETS`: Set to 1 to store only secret metadata and never ciphertext. (example: `<0-or-1>`)
- `CLIPBOARD_DATA_DIR`: Override the data directory used for the clipboard history database and related files. (example: `<your-data-directory>`)
- `CLIPBOARD_VAULT_PATH`: Path to an Obsidian vault directory for auto-mirroring non-secret clips as markdown sidecars and daily-note entries. (example: `<your-obsidian-vault-path>`)
Note: Preferred portable config path is the packaged release binary extracted from the .mcpb bundle. The MCP server runs over stdio via the 'serve' subcommand. A separate one-time background daemon installation is recommended for clipboard capture to continue while the client is closed: './ext/server/clipboard-history-mcp install'. On Linux, a working Secret Service implementation is required; on macOS, enabling window-title capture requires Accessibility permission.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Preferred portable config path is the packaged release binary extracted from the .mcpb bundle. The MCP server runs over stdio via the 'serve' subcommand. A separate one-time background daemon installation is recommended for clipboard capture to continue while the client is closed: './ext/server/clipboard-history-mcp install'. On Linux, a working Secret Service implementation is required; on macOS, enabling window-title capture requires Accessibility permission.
Tools (15)
list_history
Paginated clipboard history, newest first
get_item
Fetch a single clip by id
search_history
Search clipboard history with FTS5 across preview and window title
get_urls
Return URL clips deduplicated by hostname
get_code
Return code clips, optionally filtered by language
get_json
Return JSON clips with parsed structure
get_secrets_index
Return secret metadata only, without values
unlock_secret
Decrypt one secret, gated by Touch ID
get_stats
Return counts by kind, oldest/newest, and database size
daemon_status
Return daemon PID and running state
copy_item
Restore a clip back to the system clipboard
pin_item
Pin or unpin an item so it survives clear_history
tag_item
Add or remove a free-form tag
delete_item
Hard delete an item
Environment variables
CLIPBOARD_POLL_MSWatcher poll interval in millisecondsCLIPBOARD_HISTORY_MAXRing-buffer size for stored historyCLIPBOARD_CAPTURE_WINDOW_TITLEWhether to capture window titles for context searchCLIPBOARD_IGNORE_APPSComma-separated app names whose clipboard events should be skippedCLIPBOARD_NEVER_STORE_SECRETSParanoid mode that stores metadata only and never writes secret ciphertextCLIPBOARD_DATA_DIROverride the local data directoryCLIPBOARD_VAULT_PATHPath to an Obsidian vault for optional mirroring of non-secret clipsPackages
https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb
mcpbtransport: stdio
Details
- Language
- Rust
- License
- MIT
- Released
- May 6, 2026
- Last commit
- May 12, 2026
- Registry name
- io.github.d-khomenko/clipboard-history-mcp