squad-up-mcp

Squad Up MCP Server

An MCP (Model Context Protocol) server that exposes Squad Up's event planning capabilities to AI assistants like Claude. Users can create events, add invitees, manage potlucks and carpools, and get calendar links—all through natural language.

What is MCP?

Model Context Protocol is a standard way for AI assistants to connect to external tools. Think of it like this:

• You (Squad Up) build an MCP server that exposes "tools" (create_event, add_invitee, etc.)
• Claude is the MCP client—it discovers your tools and calls them when the user asks
• The user says "Create a potluck for Saturday" → Claude calls your create_event tool → your server talks to the Squad Up API → Claude tells the user the result

Quick Start

cd mcp-server
uv sync
SQUAD_UP_API_URL=http://localhost:8000/api uv run python -m squad_up_mcp

Configuration

Env Var	Description	Default
SQUAD_UP_API_URL	Base URL of your Squad Up API (e.g. https://your-backend.url/api)	http://localhost:8000/api

Use with Claude (for everyone)

Install Claude Desktop from claude.ai → Download the app (MCP does not work in the browser).

• Open your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

• Add Squad Up to the mcpServers section:

{
  "mcpServers": {
    "squad-up": {
      "command": "uvx",
      "args": ["squad-up-mcp"],
      "env": {
        "SQUAD_UP_API_URL": "https://your-backend.url/api"
      }
    }
  }
}

Replace with your Squad Up API URL (e.g. https://your-backend.url/api).

• Restart Claude Desktop completely (quit and reopen).

• Use it: Ask Claude to "Create a potluck for Saturday" or "Add an invitee to my event." Claude will use Squad Up tools.

Requires uv (or pip install squad-up-mcp and use "command": "python", "args": ["-m", "squad_up_mcp"]).

Testing Locally

• Start your Squad Up backend: cd backend && uv run uvicorn app.main:app --reload --port 8000
• Run the MCP server: cd mcp-server && SQUAD_UP_API_URL=http://localhost:8000/api uv run python -m squad_up_mcp
• Add to Claude Desktop config (see MCP_SERVER_GUIDE.md)

Publishing to MCP Registry

See MCP_SERVER_GUIDE.md for the full walkthrough.