MCP Integration

Create private notes directly from any MCP-compatible AI assistant or tool.

AI-PoweredEnd-to-End EncryptedOpen Protocol

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and services. PrivNote exposes an MCP endpoint that allows AI agents to create encrypted, self-destructing notes on your behalf and return the share URL — all without leaving your AI workflow.

Available Tools

create_privnote

Create an encrypted, self-destructing private note. Returns a share URL containing the decryption key.

content(required) — The plaintext note content to encrypt

expiry(optional, default: 24h) — 5m, 30m, 1h, 24h, or 7d

burnAfterReading(optional, default: true) — Delete after first read

password(optional) — Password-protect the note

Setup Instructions

Streamable HTTP (recommended)

If your MCP client supports streamable HTTP, add the server URL directly to your MCP configuration file.

{
  "mcpServers": {
    "privnote": {
      "url": "https://privnote.switch-to.eu/api/mcp/mcp"
    }
  }
}

Stdio Bridge

For MCP clients that only support stdio transport, use the mcp-remote bridge to connect over HTTP.

{
  "mcpServers": {
    "privnote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://privnote.switch-to.eu/api/mcp/mcp"
      ]
    }
  }
}

Requires mcp-remote (installed automatically via npx) to bridge stdio to HTTP.

Security Note

When creating notes via MCP, the encryption key is included in the returned share URL. The note content is encrypted with AES-256-GCM before storage — the server never sees the plaintext. However, the encryption key passes through the MCP protocol, so only use this with trusted tools and share the resulting URL through secure channels.