FreshBooks MCP Server

Automate your FreshBooks invoicing and time tracking through Claude. This MCP server provides seamless integration with FreshBooks while using Xano as the authentication backend.

🚀 Features

Send Saturday Invoices - Automate your weekly billing with one command
List Invoices - View and filter invoices by status
Log Time Entries - Track billable hours directly from Claude
Revenue Reports - Get financial insights instantly
Secure Authentication - Uses your existing Xano account for auth

🛠️ Setup

1. Get Your FreshBooks Account ID

Log into FreshBooks
Look at your URL: https://my.freshbooks.com/#/accounting/<ACCOUNT_ID>/dashboard
Copy the account ID

2. Configure the Server

Edit wrangler.jsonc:

{
  "vars": {
    "FRESHBOOKS_ACCOUNT_ID": "your-account-id-here"
  }
}

3. Deploy to Cloudflare

npm install
npx wrangler deploy

4. Connect FreshBooks on mcp.snappy.ai

Visit mcp.snappy.ai
Go to Integrations
Click "Connect FreshBooks"
Complete OAuth flow

5. Add to Claude Desktop

Edit your Claude Desktop config:

{
  "mcpServers": {
    "freshbooks": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "connect",
        "wss://freshbooks-mcp-server.your-subdomain.workers.dev/mcp"
      ]
    }
  }
}

📋 Available Tools

`freshbooks_list_invoices`

List all invoices with optional status filter

Parameters: status (optional), page (optional)

`freshbooks_send_saturday_invoices`

Send all draft invoices (perfect for Saturday billing)

Parameters: dry_run (default: true for preview)

`freshbooks_log_time`

Log billable hours for a client

Parameters: client_name, hours, description, date (optional)

`freshbooks_revenue_report`

Get revenue summary for a date range

Parameters: start_date (optional), end_date (optional)

`debug_auth_status`

Check connection status for both Xano and FreshBooks

🎯 Usage Examples

You: "Send my Saturday invoices"
Claude: [Shows preview of 3 draft invoices]

You: "Actually send them"
Claude: ✅ Sent 3 invoices totaling $4,250

You: "Log 2 hours for PVM project today"
Claude: ⏱️ Time entry created for PVM

🏗️ Architecture

Authentication: Xano (existing user management)
API Integration: FreshBooks (stored in Xano user profile)
Deployment: Cloudflare Workers
OAuth Management: mcp.snappy.ai

🔒 Security

FreshBooks credentials stored securely in your Xano account
No direct OAuth in the MCP server
User-scoped access only
Tokens auto-refresh as needed

🤝 Contributing

This is part of the Snappy MCP ecosystem. Visit mcp.snappy.ai to learn more.

📝 License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Automates FreshBooks invoicing and time tracking through Claude, allowing users to send invoices, list invoices, log billable hours, and get financial insights via natural language commands.

Related MCP Servers

Database Updater MCP Server
AnuragRai017
A
security
A
license
A
quality
A Claude integration that enables updating various database types (PostgreSQL, MySQL, MongoDB, SQLite) from CSV and Excel files through natural language commands.
Last updated -
2
1
Apache 2.0
TranscriptionTools MCP Server
MushroomFleet
A
security
A
license
A
quality
Provides intelligent transcript processing capabilities for Claude, featuring natural formatting, contextual repair, and smart summarization powered by Deep Thinking LLMs.
Last updated -
4
16
MIT License
Wave Accounting MCP Server
vinnividivicci
-
security
A
license
-
quality
Integrates Claude with Wave Accounting to automate expense tracking and income transaction creation from receipts and payment data.
Last updated -
2
MIT License
Clockify Master MCP
hongkongkiwi
-
security
F
license
-
quality
Integrates Clockify time tracking directly into Claude Desktop, enabling users to start/stop timers, manage projects and clients, create tasks, generate reports, and track productivity through natural language commands.
Last updated -
430

View all related MCP servers

FreshBooks MCP Server