Wave MCP Server

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

| Variable | Description | |----------|-------------| | WAVE_ACCESS_TOKEN | Full Access token from Wave app settings | | WAVE_BUSINESS_ID | Set automatically by auth_flow.py, or manually |

Tools & Operations

account — Chart of Accounts

| Operation | Description | |-----------|-------------| | list | List accounts with optional type/subtype filters, pagination | | get | Get account by ID | | create | Create account (name, subtype, currency, description) | | update | Update account fields | | archive | Archive an account | | search | Client-side name search |

party — Customers & Vendors

| Operation | Customer | Vendor | |-----------|----------|--------| | list | Yes | Yes | | get | Yes | Yes | | create | Yes | Read-only | | update | Yes | Read-only | | delete | Yes | Read-only | | search | Yes | Yes |

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

| Operation | Description | |-----------|-------------| | business_summary | Business info + accounts grouped by type with counts | | account_balances | All accounts with name, type, balance, balanceInBusinessCurrency | | customer_balances | All customers with outstanding and overdue amounts |

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

| | Wave | QuickBooks | |-|------|-----------| | API | GraphQL | REST | | Auth | Static Bearer token | OAuth 2.0 + token refresh | | IDs | Base64 strings | Integers | | Pagination | Page-based (page/pageSize) | Offset-based (start_position) | | Search | Client-side name filtering | Server-side WHERE queries | | Vendors | Read-only | Full CRUD | | Reports | Synthesized from account data | Native report API | | Money Transactions | Create-only (BETA) | N/A |

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)