Advertise
MCP.so
Sign In
M

MCP FreshBooks

@AlexlaGuardia

Repository

Basic information

Category

Other

Transports

stdio

Author

AlexlaGuardia

Submitted by

Alex la Guardia

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

MCP FreshBooks 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"
      }
    }
  }
}

MCP FreshBooks tools

8

`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

Frequently asked questions

1

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.

2

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.

3

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).

4

Where are authentication tokens stored?

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

5

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

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Advertise