MCP.so
ログイン
M

MCP FreshBooks

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

基本情報

カテゴリ

その他

トランスポート

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

ツール

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`

概要

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.

コメント

「その他」の他のコンテンツ