claude-desktop.md

Claude Desktop

Use this when you want Waggle available inside Claude Desktop through the desktop MCP config file.

Waggle is local graph memory for coding agents.

No cloud account. No API key. Local by default.

One-line install

pipx install waggle-mcp
waggle-mcp setup --yes --clients claude-desktop

Manual config

Add this to your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "waggle": {
      "command": "waggle-mcp",
      "args": ["serve", "--transport", "stdio"],
      "env": {
        "WAGGLE_DEFAULT_TENANT_ID": "local-default",
        "WAGGLE_DB_PATH": "~/.waggle/waggle.db"
      }
    }
  }
}

Verify

waggle-mcp doctor

Restart Claude Desktop and confirm Waggle tools appear.

Troubleshooting

See troubleshooting.md.

Security and privacy

The server runs locally over stdio. Memory stays on disk under your configured database path unless you export it.