FreshBooks Connector for AI agents.
12 live capabilities
Manage small business invoicing and bookkeeping through your AI agent.
Waiting for input…
Why people use FreshBooks
FreshBooks Invoicing and Bookkeeping Automation
This Connector changes that by bringing your accounting data directly into your AI workspace. Instead of hunting for information, you just ask your agent to show you the status of your latest invoices or list your active projects. You get the answers you need in seconds, letting you stay in your flow state while keeping your books organized.
What Vinkius changes
You get instant access to your accounting data without leaving your chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Identifying late payments
A freelancer asks the agent who hasn't paid yet.
- Real-world use case 02
Project status summaries
A manager wants to know the status of a project.
- Real-world use case 03
Expense category checks
A business owner asks how much was spent on travel.
Complete set · 12capabilities
The complete FreshBooks capability set.
These are the exact actions your AI can choose when you ask it to work with FreshBooks.
01—04
4 capabilities in this set.
Part of 12 available through FreshBooks.
- 01 Capability
List invoices
See all your sales invoices. Use this to get a bird's eye view of what's been billed.
- 02 Capability
List expense categories
See how your business expenses are grouped. This helps you understand your spending structure.
- 03 Capability
List clients
Get a full list of your customers. Use this to see who you're currently working with.
- 04 Capability
List expenses
View all recorded business expenses. This is perfect for checking what you've spent lately.
05—08
4 capabilities in this set.
Part of 12 available through FreshBooks.
- 05 Capability
List payments
See a history of all payments received. It helps you track who's actually sent you money.
- 06 Capability
List active projects
See what projects are currently underway. This keeps your current work visible.
- 07 Capability
List project tasks
See the specific tasks within a project. This helps you see what needs to be finished.
- 08 Capability
List time entries
See your logs of time spent on work. Use this to verify hours before sending a bill.
09—12
4 capabilities in this set.
Part of 12 available through FreshBooks.
- 09 Capability
Get account info
Get your business account details. This helps you confirm you're looking at the correct company data.
- 10 Capability
Get client details
Pull specific metadata for a single client. Use this to find contact info or history for a specific person.
- 11 Capability
Get invoice details
See the specifics of an individual invoice. This lets you check line items and specific dates for a single bill.
- 12 Capability
Get my identity
Fetch your user profile. It ensures your agent knows exactly who is making the request.
Set up in minutes
One URL. Then ask FreshBooks to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use FreshBooks from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_rpJ0QjeSVopDoIEXUuz2zatf0PbQCFfjaLbFRmNo/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it FreshBooks, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable FreshBooks for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_rpJ0QjeSVopDoIEXUuz2zatf0PbQCFfjaLbFRmNo/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the FreshBooks URL.
- Step 03
Save and start
Save the connection and enable FreshBooks in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"freshbooks": {
"url": "https://edge.vinkius.com/vk_preview_rpJ0QjeSVopDoIEXUuz2zatf0PbQCFfjaLbFRmNo/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using FreshBooks
Open Agent mode in chat and ask: "Using FreshBooks, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"freshbooks": {
"url": "https://edge.vinkius.com/vk_preview_rpJ0QjeSVopDoIEXUuz2zatf0PbQCFfjaLbFRmNo/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using FreshBooks
Ask Copilot: "Using FreshBooks, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"freshbooks": {
"url": "https://edge.vinkius.com/vk_preview_rpJ0QjeSVopDoIEXUuz2zatf0PbQCFfjaLbFRmNo/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using FreshBooks
Open Cascade and ask: "Using FreshBooks, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"freshbooks": {
"url": "https://edge.vinkius.com/vk_preview_rpJ0QjeSVopDoIEXUuz2zatf0PbQCFfjaLbFRmNo/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using FreshBooks
Ask Cline: "Using FreshBooks, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add freshbooks --transport http "https://edge.vinkius.com/vk_preview_rpJ0QjeSVopDoIEXUuz2zatf0PbQCFfjaLbFRmNo/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using FreshBooks
Ask Claude: "Using FreshBooks, show me...". 12 tools are ready
Where the request belongs
Work FreshBooks can move forward.
This is for the small business owner who is tired of manual data entry and the freelancer who needs to bill accurately without the headache of constant dashboard navigation.
Freelancer
Checking time logs and drafting invoices from your chat window on Tuesday afternoons.
Small Business Owner
Quickly verifying if a client paid a specific bill while in the middle of a project.
Bookkeeper
Retrieving payment histories and expense categories to summarize monthly cash flow.
Accountant
Fetching client metadata and invoice statuses to provide updates without manual searching.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsFinmei
Manage expenses, tax rates, and payments through conversational AI agents with Finmei.
Invoice Ninja
Manage clients, invoices, and products directly through AI.
Zoho Books
Manage invoices, estimates, and contacts via the Zoho Books API.
Invoice Ninja (Invoicing & Billing)
Manage invoicing via Invoice Ninja. create clients, track payments, and manage invoices and balances.
everbill
Invoice clients, track expenses, and manage your freelance finances with clean accounting capabilities that save tax season headaches.
Altoviz
Business management and invoicing. manage customers, invoices, and expenses via AI.
Bring your own AI
Change the model, client or framework. Keep FreshBooks connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about FreshBooks.
The practical details behind the request, access and result.
Can the FreshBooks MCP help me see who owes me money?
Yes. You can ask your agent to list your invoices and check their statuses. It will identify which ones are marked as overdue or sent so you can follow up with your clients.
How do I use FreshBooks with my AI agent to track my time?
Once connected, you can ask your agent to list your time entries. It will pull your logs directly from FreshBooks so you can verify your hours before billing.
Can I see my business expenses through the FreshBooks MCP?
You can. Your agent can pull your expense categories and list your recorded expenses, making it easy to see where your money is going without opening a browser.
Does this FreshBooks MCP work with Cursor or Claude?
Yes, this Connector is compatible with any MCP-supported client, including Claude, Cursor, Windsurf, and VS Code.
Can I pull specific client details using the FreshBooks MCP?
Yes. You can ask your agent to fetch the metadata for a specific client, which includes their profile information and history.
How does the FreshBooks MCP help with small business bookkeeping?
It centralizes your accounting data. You can check payments, invoices, and expenses through a natural conversation, keeping your records updated in real-time.
How do I get an Access Token for FreshBooks?
You can find your Access Token in your FreshBooks application settings or by creating a Personal Access Token in the FreshBooks Developer Portal.
Where do I find my FreshBooks Account ID?
Your Account ID is the unique number visible in your browser's URL bar immediately after '/portal/' when you are logged into FreshBooks.
Can I see if a specific invoice has been paid?
Yes! Use the 'get_invoice_details' capability and provide the Invoice ID. The agent will return the current status, including whether it is 'Sent', 'Paid', or 'Overdue'.
Is time tracking data accessible via the agent?
Yes, the 'list_time_entries' capability allows you to retrieve all time tracking logs for your business, keeping your project productivity in view.
One connection away
Give your agent a direct line to FreshBooks.
Connect FreshBooks once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available