Wave MCP Server

MCP server for Wave invoicing with built-in PDF generation. Pull invoice data from your Wave account and generate branded PDF invoices—all from Claude or any MCP-compatible AI.

Features

• 📋 List invoices from your Wave account

• 🔍 Get invoice details with customer info and line items

• 👥 List customers from Wave

• 📄 Generate PDF invoices with your branding

No Python required. Pure TypeScript with PDFKit.

Related MCP server: Invoice MCP Server

Quick Start

git clone https://github.com/YOUR_USERNAME/wave-mcp-server.git
cd wave-mcp-server
npm install
npm run build
cp .env.example .env
# Edit .env with your credentials

Getting Wave API Credentials

1. Go to developer.waveapps.com

2. Create a new application

3. Generate a Full Access token

4. Copy your Business ID from the dashboard

Configuration

Edit .env with your credentials:

WAVE_API_KEY=your_full_access_token
WAVE_BUSINESS_ID=your_business_id
BUSINESS_NAME=Your Business Name
# See .env.example for all options

Adding Your Logo

Place your logo at assets/logo.png. Recommended size: 200x200px or larger, square aspect ratio.

Claude Desktop Setup

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "wave": {
      "command": "node",
      "args": ["/path/to/wave-mcp-server/dist/index.js"]
    }
  }
}

Or with inline environment variables:

{
  "mcpServers": {
    "wave": {
      "command": "node",
      "args": ["/path/to/wave-mcp-server/dist/index.js"],
      "env": {
        "WAVE_API_KEY": "your_key",
        "WAVE_BUSINESS_ID": "your_id",
        "BUSINESS_NAME": "Your Business Name",
        "LOGO_PATH": "/path/to/assets/logo.png"
      }
    }
  }
}

Environment Variables

Available Tools

Usage Examples

Once configured, ask Claude:

• "List my Wave invoices"

• "Generate a PDF for invoice #1234"

• "Show me the details for my latest invoice"

License

MIT