Apple Notes MCP Server

Name: Apple Notes MCP Server
Author: io.github.connerkward

io.github.connerkward/mcp-apple-notes

Repository Registry

What is the Apple Notes MCP server?

Semantic search + connection-discovery across your own Apple Notes (bridges, synthesis).

How to install Apple Notes

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENAI_API_KEY
secret
Only required for synthesis. Set to 'local' when pointing SYNTH_BASE_URL at a local OpenAI-compatible server (LM Studio / Ollama); set to a funded key for real OpenAI. Search, bridges, entities run on-device with no key.
SYNTH_BASE_URL
Optional OpenAI-compatible base URL for synthesis (e.g. http://localhost:1234/v1 for LM Studio). Keeps notes on-device.
SYNTH_MODEL
Optional model id for synthesis when SYNTH_BASE_URL is set (defaults to gpt-4o-mini for real OpenAI).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "https://github.com/connerkward/mcp-apple-notes/releases/download/v1.0.2/mcp-apple-notes.mcpb",
      "args": [],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "SYNTH_BASE_URL": "<YOUR_SYNTH_BASE_URL>",
        "SYNTH_MODEL": "<YOUR_SYNTH_MODEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "https://github.com/connerkward/mcp-apple-notes/releases/download/v1.0.2/mcp-apple-notes.mcpb",
      "args": [],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "SYNTH_BASE_URL": "<YOUR_SYNTH_BASE_URL>",
        "SYNTH_MODEL": "<YOUR_SYNTH_MODEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-apple-notes": {
      "command": "https://github.com/connerkward/mcp-apple-notes/releases/download/v1.0.2/mcp-apple-notes.mcpb",
      "args": [],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "SYNTH_BASE_URL": "<YOUR_SYNTH_BASE_URL>",
        "SYNTH_MODEL": "<YOUR_SYNTH_MODEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-apple-notes": {
      "type": "stdio",
      "command": "https://github.com/connerkward/mcp-apple-notes/releases/download/v1.0.2/mcp-apple-notes.mcpb",
      "args": [],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "SYNTH_BASE_URL": "<YOUR_SYNTH_BASE_URL>",
        "SYNTH_MODEL": "<YOUR_SYNTH_MODEL>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-apple-notes --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env SYNTH_BASE_URL=<YOUR_SYNTH_BASE_URL> --env SYNTH_MODEL=<YOUR_SYNTH_MODEL> -- https://github.com/connerkward/mcp-apple-notes/releases/download/v1.0.2/mcp-apple-notes.mcpb