Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Wave MCP Server list my recent invoices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
📋 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: wave-mcp
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 credentialsGo to developer.waveapps.com
Create a new application
Generate a Full Access token
Copy your Business ID from the dashboard
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 optionsPlace your logo at assets/logo.png. Recommended size: 200x200px or larger, square aspect ratio.
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"
}
}
}
}Variable | Required | Description |
| Yes | Your Wave full-access token |
| Yes | Your Wave business ID |
| No | Business name on invoices |
| No | Address line 1 |
| No | Address line 2 |
| No | Phone number |
| No | Path to logo PNG (default: |
| No | Output directory for PDFs (default: |
Tool | Description |
| List invoices with pagination |
| Get full invoice details |
| List all customers |
| Export invoice as JSON |
| Generate branded PDF from Wave invoice |
Once configured, ask Claude:
"List my Wave invoices"
"Generate a PDF for invoice #1234"
"Show me the details for my latest invoice"
MIT
Export Wave invoice to JSON format
Inputs: invoiceId (required).
Fetch invoice from Wave and generate a branded PDF. Returns the path to the generated PDF.
Inputs: invoiceId (required), outputPath.
Get full details of a specific invoice
Inputs: invoiceId (required).
List all customers from Wave
Inputs: no named parameters.
List invoices from Wave with pagination
Inputs: page, pageSize.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool has a clearly distinct purpose: list_invoices vs get_invoice separates collection from detail, and export_invoice_json vs generate_invoice_pdf are explicitly different output formats. list_customers is entirely separate from the invoice workflow.
All tools follow a consistent lower_snake_case verb_noun pattern, with singular/plural usage matching intent (list_invoices vs get_invoice). The export/generate tools extend the pattern with an output format, which is still predictable.
Five tools is well-scoped for a focused Wave integration covering invoice retrieval, customer listing, and invoice export. Each tool earns its place without redundancy or bloat.
The invoice retrieval and export workflow is covered, but the surface has notable gaps such as no create/update/delete for invoices and no customer detail lookup. Agents can perform read-only and export tasks, but cannot complete full invoice management workflows.
Invoicing tools for AI assistants: clients, draft invoices with computed tax, and email sending.
Connect your AI to your Well financial data - invoices, companies, contacts.
Create EU-compliant invoices, manage clients and download PDFs from your AI assistant.
Create invoices from your AI assistant in 6 languages and 10 currencies, ready for WhatsApp.
