Clipboard History MCP MCP Server

Name: Clipboard History MCP MCP Server
Author: io.github.d-khomenko

io.github.d-khomenko/clipboard-history-mcp

Repository Registry

What is the Clipboard History MCP MCP server?

Your clipboard, but Claude can read it. Type-classified, secret-encrypted. macOS + Linux.

How to install Clipboard History MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CLIPBOARD_VAULT_PATH
Auto-mirror non-secret clips to this Obsidian vault directory. Sidecar `.md` per clip + bullet in `daily/YYYY-MM-DD.md`. Secrets are never mirrored.
CLIPBOARD_CAPTURE_WINDOW_TITLE
Set to '1' to capture the active window title alongside each clip (needs Accessibility permission on macOS, X11 only on Linux).
CLIPBOARD_IGNORE_APPS
Comma-separated app display names to skip (e.g. '1Password,Bitwarden,KeePassXC').
CLIPBOARD_NEVER_STORE_SECRETS
Set to '1' for paranoid mode — secrets are detected and metadata-logged but ciphertext is never stored.
CLIPBOARD_HISTORY_MAX
Maximum number of clips kept in the ring buffer. Defaults to 1000.
CLIPBOARD_POLL_MS
Watcher poll interval in milliseconds. Defaults to 1500.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "clipboard-history-mcp": {
      "command": "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb",
      "args": [],
      "env": {
        "CLIPBOARD_VAULT_PATH": "<YOUR_CLIPBOARD_VAULT_PATH>",
        "CLIPBOARD_CAPTURE_WINDOW_TITLE": "<YOUR_CLIPBOARD_CAPTURE_WINDOW_TITLE>",
        "CLIPBOARD_IGNORE_APPS": "<YOUR_CLIPBOARD_IGNORE_APPS>",
        "CLIPBOARD_NEVER_STORE_SECRETS": "<YOUR_CLIPBOARD_NEVER_STORE_SECRETS>",
        "CLIPBOARD_HISTORY_MAX": "<YOUR_CLIPBOARD_HISTORY_MAX>",
        "CLIPBOARD_POLL_MS": "<YOUR_CLIPBOARD_POLL_MS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "clipboard-history-mcp": {
      "command": "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb",
      "args": [],
      "env": {
        "CLIPBOARD_VAULT_PATH": "<YOUR_CLIPBOARD_VAULT_PATH>",
        "CLIPBOARD_CAPTURE_WINDOW_TITLE": "<YOUR_CLIPBOARD_CAPTURE_WINDOW_TITLE>",
        "CLIPBOARD_IGNORE_APPS": "<YOUR_CLIPBOARD_IGNORE_APPS>",
        "CLIPBOARD_NEVER_STORE_SECRETS": "<YOUR_CLIPBOARD_NEVER_STORE_SECRETS>",
        "CLIPBOARD_HISTORY_MAX": "<YOUR_CLIPBOARD_HISTORY_MAX>",
        "CLIPBOARD_POLL_MS": "<YOUR_CLIPBOARD_POLL_MS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "clipboard-history-mcp": {
      "command": "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb",
      "args": [],
      "env": {
        "CLIPBOARD_VAULT_PATH": "<YOUR_CLIPBOARD_VAULT_PATH>",
        "CLIPBOARD_CAPTURE_WINDOW_TITLE": "<YOUR_CLIPBOARD_CAPTURE_WINDOW_TITLE>",
        "CLIPBOARD_IGNORE_APPS": "<YOUR_CLIPBOARD_IGNORE_APPS>",
        "CLIPBOARD_NEVER_STORE_SECRETS": "<YOUR_CLIPBOARD_NEVER_STORE_SECRETS>",
        "CLIPBOARD_HISTORY_MAX": "<YOUR_CLIPBOARD_HISTORY_MAX>",
        "CLIPBOARD_POLL_MS": "<YOUR_CLIPBOARD_POLL_MS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "clipboard-history-mcp": {
      "type": "stdio",
      "command": "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb",
      "args": [],
      "env": {
        "CLIPBOARD_VAULT_PATH": "<YOUR_CLIPBOARD_VAULT_PATH>",
        "CLIPBOARD_CAPTURE_WINDOW_TITLE": "<YOUR_CLIPBOARD_CAPTURE_WINDOW_TITLE>",
        "CLIPBOARD_IGNORE_APPS": "<YOUR_CLIPBOARD_IGNORE_APPS>",
        "CLIPBOARD_NEVER_STORE_SECRETS": "<YOUR_CLIPBOARD_NEVER_STORE_SECRETS>",
        "CLIPBOARD_HISTORY_MAX": "<YOUR_CLIPBOARD_HISTORY_MAX>",
        "CLIPBOARD_POLL_MS": "<YOUR_CLIPBOARD_POLL_MS>"
      }
    }
  }
}

Claude Code

claude mcp add clipboard-history-mcp --env CLIPBOARD_VAULT_PATH=<YOUR_CLIPBOARD_VAULT_PATH> --env CLIPBOARD_CAPTURE_WINDOW_TITLE=<YOUR_CLIPBOARD_CAPTURE_WINDOW_TITLE> --env CLIPBOARD_IGNORE_APPS=<YOUR_CLIPBOARD_IGNORE_APPS> --env CLIPBOARD_NEVER_STORE_SECRETS=<YOUR_CLIPBOARD_NEVER_STORE_SECRETS> --env CLIPBOARD_HISTORY_MAX=<YOUR_CLIPBOARD_HISTORY_MAX> --env CLIPBOARD_POLL_MS=<YOUR_CLIPBOARD_POLL_MS> -- https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb