Skip to content

Overview

The mindpad MCP server lets you save notes directly from AI assistants like Claude Desktop and Cursor — without leaving your workflow.

  1. Generate a Personal Access Token

    Go to mindpad → Account Settings → API and generate a Personal Access Token (PAT). Copy it — it’s only shown once.

  2. Add to your AI assistant

    Add the following to your MCP client config:

    {
    "mcpServers": {
    "mindpad": {
    "command": "npx",
    "args": ["-y", "@mindpad/mcp"],
    "env": {
    "MINDPAD_PAT": "your-pat-here"
    }
    }
    }
    }
  3. Restart your AI assistant

    Your assistant will now have access to the mindpad tools.

Just talk naturally — your assistant will save notes when you ask:

  • “Save a note about today’s meeting”
  • “Jot this down: pick up groceries !errand”
  • “Remember that the API key expires on Friday !work”

Tags can be added inline using !tagname.

Saves a note to your mindpad account.

ParameterTypeRequiredDescription
contentstringYesThe note content in markdown. Use !tagname to add tags inline.

The MCP server authenticates using a Personal Access Token (PAT) passed via the MINDPAD_PAT environment variable. The token is sent as a Bearer token to the mindpad API on every request.

The MCP server forwards the note content you provide to the mindpad API.

When using the web app, notes are encrypted client-side before being sent to the server. When using the API (including via MCP), notes are encrypted server-side before storage.

The AI assistant never has access to your existing notes or your encryption key. It can only save new content that you explicitly instruct it to create.