Before you start: WIP Notes must be installed and opened at least once (so its database exists), and Node.js must be installed on your Mac. That's it — no accounts, no API keys, no additional setup.

Claude

Claude Desktop

Claude for Mac — claude.ai/download

1

Open this file in a text editor (create it if it doesn't exist):

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

2

Add the wip-notes entry under mcpServers:

{
  "mcpServers": {
    "wip-notes": {
      "command": "npx",
      "args": ["-y", "wip-notes-mcp"]
    }
  }
}

If the file already has other servers, add wip-notes alongside them inside the existing mcpServers block.

3

Save the file and restart Claude Desktop. A hammer icon in the chat toolbar confirms the tools are active.

Gemini

Gemini CLI

Google's command-line AI tool — same config schema as Claude

1

Create (or edit) the Gemini settings file at:

~/.gemini/settings.json

2

Add the same mcpServers block — the schema is identical to Claude Desktop:

{
  "mcpServers": {
    "wip-notes": {
      "command": "npx",
      "args": ["-y", "wip-notes-mcp"]
    }
  }
}
3

Save and restart any active Gemini CLI session. The tools will be available in your next session.

ChatGPT

ChatGPT Desktop

OpenAI's Mac app — no config file, all done in the UI

1

Open ChatGPT Desktop and navigate to Settings → Connectors → Add.

2

Fill in the two fields:

Command npx
Arguments -y wip-notes-mcp
3

Save the connector. No restart required — the tools are available immediately in a new chat.