Skip to content
MCP server

Clipboard History MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.5.0-alpha.0
Listing updated
5 days ago

About Clipboard History MCP

Clipboard History MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add clipboard-history-mcp -- npx -y https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "clipboard-history-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clipboard-history-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "clipboard-history-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "clipboard-history-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "clipboard-history-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CLIPBOARD_VAULT_PATHAuto-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_TITLESet to '1' to capture the active window title alongside each clip (needs Accessibility permission on macOS, X11 only on Linux).
  • CLIPBOARD_IGNORE_APPSComma-separated app display names to skip (e.g. '1Password,Bitwarden,KeePassXC').
  • CLIPBOARD_NEVER_STORE_SECRETSSet to '1' for paranoid mode — secrets are detected and metadata-logged but ciphertext is never stored.
  • CLIPBOARD_HISTORY_MAXMaximum number of clips kept in the ring buffer. Defaults to 1000.
  • CLIPBOARD_POLL_MSWatcher poll interval in milliseconds. Defaults to 1500.

Pricing

Open source

Clipboard History MCP FAQ

Is Clipboard History MCP free?

Yes. Clipboard History MCP is open source, so you can use and self-host it for free.

How do I add Clipboard History MCP to Claude Code?

Run this command in your terminal: claude mcp add clipboard-history-mcp -- npx -y https://github.com/d-khomenko/clipboard-history-mcp/releases/download/v0.5.0-alpha.0/clipboard-history-mcp.mcpb

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers