MCP FreshBooks

Name: MCP FreshBooks
Author: AlexlaGuardia

@AlexlaGuardia

关于 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

基本信息

分类

其他

传输方式

stdio

发布者

AlexlaGuardia

提交者

Alex la Guardia

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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"
      }
    }
  }
}

工具

`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`

概览

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.