MCP FreshBooks

Name: MCP FreshBooks
Author: AlexlaGuardia

@AlexlaGuardia

About MCP FreshBooks

Production-grade MCP server for FreshBooks — 25 tools for invoices, clients, expenses, payments, time tracking, projects, estimates, and financial reports. OAuth2 with automatic token refresh.

#freshbooks #accounting #invoices #mcp #oauth2 #python

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "freshbooks": {
      "command": "mcp-freshbooks",
      "env": {
        "FRESHBOOKS_CLIENT_ID": "your_client_id",
        "FRESHBOOKS_CLIENT_SECRET": "your_client_secret",
        "FRESHBOOKS_REDIRECT_URI": "https://localhost:8555/callback"
      }
    }
  }
}

Tools

`freshbooks_authenticate`, `freshbooks_authenticate_with_code`, `freshbooks_whoami`

`list_invoices`, `get_invoice`, `create_invoice`, `update_invoice`, `send_invoice`, `delete_invoice`

`list_clients`, `get_client`, `create_client`, `update_client`

`list_expenses`, `get_expense`, `create_expense`

`list_payments`, `create_payment`

`list_projects`, `create_project`

`list_estimates`, `create_estimate`

`get_report`

Overview

What is MCP FreshBooks?

MCP FreshBooks is a production-grade MCP server that provides 25 tools for interacting with the FreshBooks accounting platform. It covers invoices, clients, expenses, payments, time tracking, projects, estimates, and financial reports. The server uses OAuth2 authentication with automatic token refresh and is intended for developers and power users who want to manage FreshBooks data via an MCP-compatible client like Claude Desktop.

How to use MCP FreshBooks?

Install the package via pip install mcp-freshbooks, then obtain FreshBooks OAuth credentials by signing up at the developer portal. Set the environment variables FRESHBOOKS_CLIENT_ID, FRESHBOOKS_CLIENT_SECRET, and FRESHBOOKS_REDIRECT_URI. Add the server to your claude_desktop_config.json under mcpServers. On first use, invoke the freshbooks_authenticate tool to initiate the OAuth2 flow; tokens are saved to ~/.mcp-freshbooks/tokens.json and refresh automatically.

Key features of MCP FreshBooks

25 tools covering the full FreshBooks accounting workflow
OAuth2 authentication with automatic token refresh
Clean, summarized list and formatted detail outputs
Production-grade error handling and rate limit awareness
Zero cost – uses FreshBooks free developer program

Use cases of MCP FreshBooks

List overdue invoices and follow up with clients
Create and send invoices with line items in a single workflow
Pull profit and loss reports for a given quarter or year
Create time entries for specific projects and tasks

FAQ from MCP FreshBooks

What tools are included in MCP FreshBooks?

The server includes 25 tools across auth, invoices, clients, expenses, payments, time tracking, projects, estimates, and reports. A full tool table is provided in the README.

How do I authenticate MCP FreshBooks with FreshBooks?

On first use, run the freshbooks_authenticate tool. It returns a URL to open in your browser. After authorizing, tokens are saved to ~/.mcp-freshbooks/tokens.json and refresh automatically.

What are the prerequisites for using MCP FreshBooks?

Python 3.10+, a FreshBooks account (free trial works for development), and FreshBooks OAuth app credentials (Client ID and Client Secret).

Where are authentication tokens stored?

Tokens are stored in ~/.mcp-freshbooks/tokens.json.

Does MCP FreshBooks cost anything?

No. It uses FreshBooks’ free developer program, so there is no cost to use the server.

Comments

More Other MCP servers

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K