FreshBooks
Manage FreshBooks (invoices, clients, expenses, time entries, payments) from any AI agent. 9 tools, OAuth2 auth.
7 天免费 · 无需信用卡 · EU 托管
问 FreshBooks 任何事
通过 AnythingMCP 对 FreshBooks 试一个真实提示 — Claude 调用工具并返回答案。在你的消息上按 Enter 即可在 Cloud 安装。
在 Cloud 上安装 FreshBooksClaude 是 AI,可能会出错。请核对回答。
2 分钟设置
- 1在 cloud.anythingmcp.com 开始免费试用。
- 2在连接器商店点击 FreshBooks。提示时粘贴凭据。
- 3生成 MCP API 密钥,将 AI 客户端指向生成的 MCP URL。
FreshBooks 指南
面向主流 AI 客户端的逐步设置。
配置 FreshBooks
直接来自连接器定义:在哪里获取凭据、需要哪些权限,以及该适配器调用的是哪个 API。 由连接器作者以英文提供。
This connector wraps the FreshBooks New API (api.freshbooks.com/accounting). You authorize it once, in AnythingMCP; access tokens are then renewed automatically.
Setup:
- Go to https://my.freshbooks.com/#/developer → Create an App. Add the redirect URI
https://cloud.anythingmcp.com/api/mcp-oauth/callbackon AnythingMCP Cloud, or<your AnythingMCP server URL>/api/mcp-oauth/callbackwhen you host AnythingMCP yourself, and select the scopes listed below. - Enter the app's Client ID as
FRESHBOOKS_CLIENT_IDand its Client Secret asFRESHBOOKS_CLIENT_SECRET, setFRESHBOOKS_ACCOUNT_ID(step 4), leaveFRESHBOOKS_REFRESH_TOKENempty, and install. - Open the connector and click Authorize with Provider. Sign in to FreshBooks, allow access, and you land back on the connector page with the tools ready.
- Account ID: the FreshBooks API requires an Account ID (
bzz...) on most endpoints. If you do not know it, install with any placeholder, authorize, runfreshbooks_me(theaccountidof your business) and set the real value inFRESHBOOKS_ACCOUNT_ID.
Scopes: user:profile:read user:clients:read user:clients:write user:invoices:read user:invoices:write user:expenses:read user:payments:read user:payments:write, which covers every tool here. The app must have the same scopes selected.
Already have a refresh token? You can paste it into FRESHBOOKS_REFRESH_TOKEN instead of step 3, if you obtained it yourself for the same app. FreshBooks refresh tokens work only once and only the newest one is valid, so a token you already exchanged, for example while testing it, is spent and the connector fails with invalid_grant. Authorizing from the connector page avoids this.
Authentication: OAuth2 with the engine's refresh handling. Access token sent as Bearer. Account ID goes in the URL path on most endpoints — substituted via runtime envVar.
Two-account-types: classic 'accounting' (US) and 'projects' (international, the new product). This adapter covers the accounting endpoints.
Response shape: FreshBooks wraps everything in {response: {result: {<entity_plural>: [...]}}}. The adapter does not unwrap automatically — handle in the caller.
Pagination: page (1-based) + per_page (max 100). Cursor on some newer endpoints.
Rate limits: 30 req/min per token, 3600/hr. 429 → exponential.
Out of scope here: reports, journal entries, project tracking (separate /projects API).