Connect notebin.ca to your MCP client

Use your notes from an AI assistant.

MCP for AI agents

notebin.ca runs a Model Context Protocol server at https://notebin.ca/mcp, so Claude Desktop, Cursor, the MCP Inspector, and other agents can manage your notes directly.

Option A — OAuth (interactive clients)

Add https://notebin.ca/mcp as a remote MCP server in your client, then sign in with your Pastebin.ca account.

In Claude, open Customize → Connectors → Add → Custom → Web, enter the URL and use Claude’s published identity when prompted.

Try it Turn this conversation into a short Markdown note and publish it as unlisted.

Option B — API-key bearer (automation)

For headless/server-side use, send a minted key directly:

{
  "mcpServers": {
    "notebin": {
      "url": "https://notebin.ca/mcp",
      "headers": { "Authorization": "Bearer pbca_live_…" }
    }
  }
}

Tools

ToolScopePurpose
whoami—Echo account id, scopes, audience, and token kind.
get_notenote:readFetch a note: metadata + Markdown source.
list_my_notesnote:readList the caller's notes; cursor-paginated.
create_notenote:createPublish a Markdown note; returns id + URLs.
delete_notenote:deleteDelete one of the caller's notes.
MCP upload capMCP accepts up to 256 KB per note. Send plain UTF-8 Markdown in the JSON-RPC request. REST accepts up to 256 KB per note.

OAuth & DPoP

pastebin.ca is the OAuth authorization server; notebin.ca is a protected resource and never mints tokens.

  • OAuth tokens are audience-bound to https://notebin.ca/mcp (RFC 8707) and honored only on the MCP route.
  • If a key is DPoP-bound (RFC 9449), every MCP request must carry a matching ES256 proof; replays are rejected. Plain bearer keys work without DPoP.
  • Revoke a key or connected app anytime from your pastebin.ca account.

Discovery

Machine-readable metadata for clients and agents: