使用说明

Good Samaritan Software的FreshBooks MCP

从Claude或ChatGPT用简单的英语管理你的FreshBooks。 FreshBooks MCP 是一个完全托管的服务-没有本地安装，没有要管理的API密钥，一个OAuth登录到您的FreshBooks帐户。默认情况下，92个工具中有41个是只读的；在任何数据更改之前，写入操作会在您的AI客户端中显示一个确认步骤。

开始→ · 文档 · 定价-每月29美元起

目前可在美国。国际候补名单可通过上述链接获得。

你能做什么

92工具 涵盖发票、客户、费用、时间跟踪、项目、付款、供应商、账单和报告——41个只读工具用于安全查找，51个写工具用于全面账户管理。

示例提示：

“显示所有超过500美元的未付发票”
“为Acme Corp开具30天后到期的1500美元发票”
“我今年的利润和亏损是多少？”
“在网站重新设计项目上登录2小时”
“为此客户端会议启动计时器”
“记录45美元的办公用品费用”
“列出我本季度支付的所有供应商”

快速入门--托管服务（推荐）

最快的方法：订阅、连接FreshBooks、将配置粘贴到AI客户端。

克劳德（桌面、代码、网络）

首选 freshbooks.goodsamsoftware.com，创建一个帐户，然后连接您的FreshBooks帐户。从仪表板复制API密钥。
添加到您的Claude桌面配置(claude_desktop_config.json)或Claude Code项目配置(.mcp.json):

{
  "mcpServers": {
    "freshbooks": {
      "command": "npx",
      "args": ["mcp-remote", "https://freshbooks.goodsamsoftware.com/api/mcp", "--header", "Authorization:Bearer YOUR_API_KEY"]
    }
  }
}

ChatGPT

在ChatGPT中，转到 设置→ 连接器→ 添加连接器.
输入MCP服务器URL： https://freshbooks.goodsamsoftware.com/api/mcp
完成OAuth流程以连接您的FreshBooks帐户。

其他MCP客户端（游标、Windsurf、Continue、Cline等）

使用相同 mcp-remote 上面显示的配置，替换客户端的配置位置。

可用工具（共92个）

发票（6个工具）

工具	只读	说明
`invoice_list`	✓	列出带有过滤器的发票
`invoice_single`	✓	按ID获取发票
`invoice_share_link`	✓	获取可共享的支付链接
`invoice_create`		创建发票
`invoice_update`		更新发票
`invoice_delete`		删除发票

客户端（5个工具）

工具	只读	说明
`client_list`	✓	列出客户
`client_single`	✓	按ID获取客户端
`client_create`		创建客户端
`client_update`		更新客户端
`client_delete`		删除客户端

时间追踪（9个工具）

工具	只读	说明
`timeentry_list`	✓	使用筛选器列出时间条目
`timeentry_single`	✓	按ID获取时间条目
`timer_current`	✓	获取运行计时器
`timeentry_create`		创建时间条目
`timeentry_update`		更新时间条目
`timeentry_delete`		删除时间条目
`timer_start`		启动计时器
`timer_stop`		停止计时器并保存条目
`timer_discard`		丢弃运行计时器

项目（5个工具）

工具	只读	说明
`project_list`	✓	列出项目
`project_single`	✓	按ID获取项目
`project_create`		创建项目
`project_update`		更新项目
`project_delete`		删除项目

费用（5个工具）

工具	只读	说明
`expense_list`	✓	列出费用
`expense_single`	✓	按ID获取费用
`expense_create`		产生费用
`expense_update`		更新费用
`expense_delete`		删除费用

付款（5种工具）

工具	只读	说明
`payment_list`	✓	列出发票付款
`payment_single`	✓	通过ID获取付款
`payment_create`		记录付款
`payment_update`		更新付款
`payment_delete`		删除付款

账单（10个工具）

工具	只读	说明
`bill_list`	✓	列出账单
`bill_single`	✓	按ID获取账单
`billpayment_list`	✓	列出账单付款
`billpayment_single`	✓	通过ID获取账单付款
`bill_create`		创建账单
`bill_archive`		存档账单
`bill_delete`		删除账单
`billpayment_create`		记录账单付款
`billpayment_update`		更新账单付款
`billpayment_delete`		删除账单付款

供应商（5种工具）

工具	只读	说明
`billvendor_list`	✓	列出供应商
`billvendor_single`	✓	按ID获取供应商
`billvendor_create`		创建供应商
`billvendor_update`		更新供应商
`billvendor_delete`		删除供应商

报告（3个工具-全部为只读）

工具	说明
`report_profit_loss`	损益报告
`report_payments_collected`	收款报告
`report_tax_summary`	税务汇总报告

其他工具

类别	计数	只读	描述
贷记通知	5	2	创建和管理贷方票据
费用类别	2	2	浏览费用类别
物品	4	2	产品/服务目录
日记账分录	2	1	手工会计分录
其他收入	5	2	非发票收入跟踪
支付选项	3	2	支付网关设置
服务	5	3	计费服务类型，包括费率获取/设置
任务	5	2	项目任务管理
用户	1	1	当前用户信息
回调	7	2	Webhook管理

自托管设置

您还可以使用自己的FreshBooks OAuth应用程序在本地运行MCP服务器。这是可选的——大多数用户应该使用上面的托管服务。

注： FreshBooks要求所有OAuth回调URL（包括localhost）都使用HTTPS。看本地HTTPS设置在......下面

1.获取FreshBooks证书

首选 FreshBooks开发者门户
创建新应用程序
将重定向URI设置为： https://freshbooks.goodsamsoftware.com/callback
记下您的客户端ID和客户端密码

2.安装和配置

npm install @goodsamsoftware/freshbooks-mcp

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "freshbooks": {
      "command": "npx",
      "args": ["@goodsamsoftware/freshbooks-mcp"],
      "env": {
        "FRESHBOOKS_CLIENT_ID": "your-client-id",
        "FRESHBOOKS_CLIENT_SECRET": "your-client-secret",
        "FRESHBOOKS_REDIRECT_URI": "https://freshbooks.goodsamsoftware.com/callback"
      }
    }
  }
}

3.身份验证

问克劳德： “将我连接到FreshBooks”

Claude将指导您完成OAuth。授权后，从以下位置复制代码托管回调页面并将其粘贴回克劳德。

环境变量

变量	必填	描述
`FRESHBOOKS_CLIENT_ID`	是	OAuth客户端ID
`FRESHBOOKS_CLIENT_SECRET`	是	OAuth客户端密钥
`FRESHBOOKS_REDIRECT_URI`	yes	OAuth重定向类型
`FRESHBOOKS_TOKEN_PATH`	否	令牌存储路径
`LOG_LEVEL`	否	日志记录级别（调试、信息、警告、错误）

高级：本地HTTPS设置

对于本地回调URL，使用以下参数设置受信任的证书 mkcert:

窗户： winget install FiloSottile.mkcert macOS： brew install mkcert Linux： 看 mkcert安装

mkcert -install
mkdir certs
mkcert -key-file certs/localhost-key.pem -cert-file certs/localhost.pem localhost 127.0.0.1 ::1

然后将重定向URI设置为 https://localhost:3000/callback 在FreshBooks。

发展

npm install          # Install dependencies
npm run dev          # Run in development mode
npm test             # Run tests
npm run test:coverage  # Run with coverage report
npm run typecheck    # Type check
npm run build        # Build for production

测试

1613次测试 93个测试文件
100%代码覆盖率 要求
所有FreshBooks实体的模拟工厂

建筑

src/
├── server.ts             # MCP server entry point
├── auth/                 # OAuth2 authentication
├── client/               # FreshBooks SDK wrapper
├── errors/               # Error normalization
├── tools/                # MCP tool implementations (22 categories)
│   ├── time-entry/       # Time tracking
│   ├── timer/            # Timer management
│   ├── invoice/          # Invoicing
│   ├── client/           # Client management
│   ├── project/          # Projects
│   ├── expense/          # Expenses
│   ├── bill/             # Bills
│   └── ...               # 15 more categories
└── config/               # Configuration

FreshBooks管理工具

使用说明

Good Samaritan Software的FreshBooks MCP

你能做什么

快速入门--托管服务（推荐）

克劳德（桌面、代码、网络）

ChatGPT

其他MCP客户端（游标、Windsurf、Continue、Cline等）

可用工具（共92个）

发票（6个工具）

客户端（5个工具）

时间追踪（9个工具）

项目（5个工具）

费用（5个工具）

付款（5种工具）

账单（10个工具）

供应商（5种工具）

报告（3个工具-全部为只读）

其他工具

自托管设置

1.获取FreshBooks证书

2.安装和配置

3.身份验证

环境变量

高级：本地HTTPS设置

发展

测试

建筑

文档

许可证

积分

使用说明

Good Samaritan Software的FreshBooks MCP

你能做什么

快速入门--托管服务（推荐）

克劳德（桌面、代码、网络）

ChatGPT

其他MCP客户端（游标、Windsurf、Continue、Cline等）

可用工具（共92个）

发票（6个工具）

客户端（5个工具）

时间追踪（9个工具）

项目（5个工具）

费用（5个工具）

付款（5种工具）

账单（10个工具）

供应商（5种工具）

报告（3个工具-全部为只读）

其他工具

自托管设置

1.获取FreshBooks证书

2.安装和配置

3.身份验证

环境变量

高级：本地HTTPS设置

发展

测试

建筑

文档

许可证

积分

相关 MCP

小红书MCP服务

Figma MCP集成工具

MCP 协议测试服务器

Flomo笔记服务

Unity编辑器AI集成插件

科学研究的开源MCP服务器