Wave MCP Server

MCP server for Wave accounting — 6 tools, 52 operations covering the full Wave GraphQL API.

Built with FastMCP and httpx. Mirrors the architecture of quickbooks-mcp.

Quick Start

# Install dependencies
uv sync

# Configure credentials
cp .env.example .env
# Edit .env — add your WAVE_ACCESS_TOKEN from Wave > Settings > API Applications

# Discover your business ID
uv run python auth_flow.py

# Run (STDIO for Claude Desktop / MCP clients)
uv run python server.py

# Run (SSE on port 3076)
uv run python server.py sse

Configuration

Tools & Operations

account — Chart of Accounts

party — Customers & Vendors

transaction — Invoices & Money Transactions

Invoice operations: list, get, create, update, delete, clone, send, approve, mark_sent, create_payment, search

Money transaction operations: create, bulk_create (BETA)

item — Products & Services

list, get, create, update, archive, search

reference — Lookup Data & Settings

list_businesses, get_business, get_user, list_currencies, list_countries, list_account_types, list_account_subtypes, list_sales_taxes, get_sales_tax, create_sales_tax, update_sales_tax, archive_sales_tax, list_estimates, get_estimate

report — Synthesized Summaries

MCP Client Configuration

Claude Desktop / Claude Code (STDIO)

{
  "mcpServers": {
    "wave": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/wave-mcp", "python", "server.py"]
    }
  }
}

SSE (remote / multi-client)

{
  "mcpServers": {
    "wave": {
      "url": "http://localhost:3076/sse"
    }
  }
}

Key Differences from QuickBooks MCP

Known Limitations

• Vendors are read-only — no create/update/delete mutations in the Wave API
• Money transactions are create-only (BETA) — no list/get/update/delete
• No server-side text search — client-side filtering, limited to first ~250 results per query
• No financial reports API — synthesized account balance summaries only
• Estimates are read-only — no create/update mutations
• Rate limit: 60 requests/minute (automatic exponential backoff on 429)