bub-mcp

Connect Bub birthday reminders to Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP clients.

Once connected, you can ask Claude things like:

• "When is Sarah's birthday?"
• "Add a birthday for Tom on March 15th"
• "Who has a birthday coming up this week?"
• "Add a note about Tom: he mentioned he loves hiking"
• "Parse these birthdays: John 4/20, Lisa Dec 3, Mike 1990-07-14"

Quick start

npx bub-mcp

The setup wizard will:

1. Log you in (or create a Bub account)
2. Generate an MCP authentication token
3. Auto-detect your installed MCP clients
4. Write the config for you

Restart your MCP client and you're good to go.

Supported clients

• Claude Desktop (macOS, Windows, Linux)
• Claude Code
• Cursor
• Windsurf

If no supported client is detected, the CLI prints the JSON config so you can add it manually.

Options

npx bub-mcp [options]

  --api-url <url>   API base URL (default: https://api.bub.club)
  --help, -h        Show help

Available tools

Once connected, your MCP client gets access to these tools:

| Tool | Description | |------|-------------| | list_events | List upcoming events (birthdays, anniversaries, etc.) | | add_event | Add an event for a person (defaults to birthday) | | update_event | Update an existing event | | remove_event | Remove an event | | parse_events_from_text | Extract events from free-form text | | search_people | Search people by name | | get_person | Get details for a specific person including events and notes | | add_person | Add a new person | | add_note | Add a timestamped note to a person | | list_notes | List all notes for a person, most recent first | | update_note | Update an existing note | | remove_note | Delete a note | | toggle_important | Mark or unmark someone as important | | get_profile | View your Bub profile | | set_email_notifications | Configure email notification preferences | | get_share_link | Get your public share link |

Manual configuration

If you prefer to set things up by hand, add this to your MCP client config:

{
  "mcpServers": {
    "bub": {
      "url": "https://mcp.bub.club/sse",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Generate a token at bub.club/mcp or by running npx bub-mcp.

Requirements

• Node.js 18+

License

MIT