MCP Setup

Connect PromptNote to Claude, Cursor, VS Code, Windsurf, and other AI tools via Model Context Protocol.

The PromptNote MCP server lets AI assistants access your prompt library. Use your prompts directly in any MCP-compatible tool.

Step 1 — Generate an API token

Sign in and open MCP / API Access (or click your avatar → MCP / API Access)
Click Generate API Token
Copy the pn_... token immediately — it is only shown once

Step 2 — Connect your AI tool

Pick your client below. All use the same server URL and token.

Server URL:

https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "promptnote": {
      "type": "http",
      "url": "https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp",
      "headers": {
        "Authorization": "Bearer pn_YOUR_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

Run this command in your terminal:

claude mcp add --transport http promptnote \
  https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp \
  --header "Authorization: Bearer pn_YOUR_TOKEN_HERE"

This adds PromptNote to your Claude Code MCP configuration. The server is available immediately — no restart needed.

Cursor

Go to Settings → MCP Servers → Add new MCP server, or edit your Cursor MCP config directly:

{
  "mcpServers": {
    "promptnote": {
      "type": "http",
      "url": "https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp",
      "headers": {
        "Authorization": "Bearer pn_YOUR_TOKEN_HERE"
      }
    }
  }
}

Toggle the server off and on in settings if tools don’t appear right away.

VS Code (Copilot)

Create or open .vscode/mcp.json in your project (or run MCP: Open User Configuration for global setup):

{
  "servers": {
    "promptnote": {
      "type": "http",
      "url": "https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp",
      "headers": {
        "Authorization": "Bearer pn_YOUR_TOKEN_HERE"
      }
    }
  }
}

Requires VS Code 1.99+ with GitHub Copilot agent mode enabled.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json (or click View raw config in Windsurf MCP settings):

{
  "mcpServers": {
    "promptnote": {
      "serverUrl": "https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp",
      "headers": {
        "Authorization": "Bearer pn_YOUR_TOKEN_HERE"
      }
    }
  }
}

Click Refresh in Windsurf MCP settings after saving.

Zed

Add to your Zed settings (~/.config/zed/settings.json):

{
  "context_servers": {
    "promptnote": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp",
        "--header", "Authorization: Bearer pn_YOUR_TOKEN_HERE"
      ]
    }
  }
}

OpenCode

Add to your OpenCode config (~/.config/opencode/config.json):

{
  "mcp": {
    "promptnote": {
      "type": "remote",
      "url": "https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp",
      "headers": {
        "Authorization": "Bearer pn_YOUR_TOKEN_HERE"
      }
    }
  }
}

Other MCP clients

Any MCP client that supports remote HTTP servers can connect to PromptNote. You need:

Field	Value
Server URL	`https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp`
Transport	HTTP (Streamable HTTP)
Auth header	`Authorization: Bearer pn_YOUR_TOKEN_HERE`

For stdio-only clients, use the mcp-remote bridge:

npx mcp-remote https://tafnybfhwybgijozwfyq.supabase.co/functions/v1/promptnote-mcp/mcp \
  --header "Authorization: Bearer pn_YOUR_TOKEN_HERE"

Step 3 — Test

Ask your AI assistant:

“List my notes from PromptNote”

“Search my prompts for ‘system prompt’”

If tools appear and return your data, setup is complete. See the Tool Reference for everything you can do.

Troubleshooting

“Server not responding” or connection error

Verify the URL is exactly as shown above (no trailing spaces)
Ensure the Authorization header uses Bearer (with a space) before the token
Restart your AI tool after editing the config file

“Authentication failed” or empty results

Check your token starts with pn_ and was pasted completely
Token may have been revoked — generate a new one from the web app
Verify you have notes in your account at app.promptnoteapp.com

Tools not appearing

Make sure the config JSON is valid (no trailing commas, correct nesting)
Claude Desktop: fully quit and relaunch (not just close the window)
Cursor: toggle the MCP server off and on in settings
VS Code: ensure Copilot agent mode is enabled
Windsurf: click Refresh after saving config

Security

All queries are scoped to your account — you can only access your own data
Shared tag notes from other users are read-only
API tokens are hashed before storage — the plain token is never stored