How to connect Freeagent to Grok Bot

Connect Grok Bot to Freeagent MCP. List overdue invoices for this month, create a new expense for office supplies, and more using natural language, with authentication handled for you.

Freeagent logoFreeagent
Oauth2

Freeagent is a cloud-based accounting platform designed for freelancers and small businesses. It simplifies bookkeeping, invoicing, and expense management in one place.

107 Tools

Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.

This guide explains how to connect Freeagent to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Freeagent in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Freeagent with

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the model context to keep conversations lean.

Connecting Freeagent to Grok Bot

Once Grok Bot is set up, you connect Freeagent entirely from its interface, and the whole flow takes under a minute.

Set up Grok Bot

Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from x.ai/bot and sign in. An iPhone companion app is also available, and your bots sync across devices.

Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.

Connect Freeagent

1. Add the Composio plugin

Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.

Add to Grok Bot

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.

Composio authorization screen with Authorize and Deny

3. Connect your Freeagent account

Back in the chat, ask your bot to connect to Freeagent or give it any Freeagent task.

For example, ask it to:

  • "List overdue invoices for this month"
  • "Create a new expense for office supplies"
  • "Summarize all unassigned transactions"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your Freeagent account is ready to use.

What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.

With Composio Connect, your Grok bot can securely access apps like Freeagent through MCP without you sharing account credentials directly with the agent.

What is the Freeagent MCP server, and what's possible with it?

The Freeagent MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Freeagent account. It provides structured and secure access to your accounting records, so your agent can create invoices, record timeslips, review expenses, monitor cash flow, and track tax deadlines on your behalf.

  • Invoices, estimates, and credit notes: Have your agent create invoices, estimates, and credit notes, convert estimates into invoices, or convert eligible invoices into credit notes.
  • Financial reporting: Let the agent retrieve cash flow, profit and loss, trial balance, balance sheet, opening balance, and accounting transaction details for your business.
  • Expenses, bills, and banking: Direct your agent to list or update expenses, create bills with attachments, review bills and bank transactions, or create and list bank accounts.
  • Contacts, projects, and time tracking: Instruct your agent to create contacts and projects, review existing records, and add timeslips for completed work.
  • Tax and VAT planning: Have your agent list VAT returns and check your company tax timeline for upcoming events and deadlines.

Way Forward

Now that Freeagent is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

TOOLS

Supported Tools

Every Freeagent action and event your agent gets out of the box.

Cashflow summary for a date range

Tool to retrieve cashflow summary for a given date range from FreeAgent.

Get Company Details

Tool to retrieve company details from FreeAgent.

Create a Journal Set

Tool to create a journal set in FreeAgent.

Create Sales Tax Period

Tool to create a sales tax period in FreeAgent.

Create Task Under Project

Tool to create a task under a specific project in FreeAgent.

Create A Timeslip

Tool to create a new timeslip in FreeAgent.

Create a User

Tool to create a new user in FreeAgent.

Create Bank Account

Tool to create a bank account in FreeAgent.

Create Bill with Attachment

Tool to create a bill with optional attachment in FreeAgent.

Create Category

Tool to create a custom category in FreeAgent.

Create Contact

Tool to create a new contact in FreeAgent.

Create Credit Note

Tool to create a credit note in FreeAgent.

Create Credit Note Reconciliation

Tool to create a credit note reconciliation in FreeAgent.

Create Estimate

Tool to create a new estimate in FreeAgent.

Create Estimate Item

Tool to create an estimate item in FreeAgent.

Duplicate Estimate

Tool to duplicate an existing estimate in FreeAgent.

Send Estimate Email

Tool to email an estimate in FreeAgent.

Create Expense

Create a single standard or mileage expense in FreeAgent.

Create Invoice

Tool to create an invoice in FreeAgent.

Create Invoice Item

Tool to create an invoice item in FreeAgent.

Duplicate Invoice

Tool to duplicate an existing invoice in FreeAgent.

Create Note

Tool to create a note for a contact or project in FreeAgent.

Create Price List Item

Tool to create a price list item in FreeAgent.

Create Project

Tool to create a project in FreeAgent.

Delete Attachment

Permanently delete a FreeAgent attachment by its numeric ID.

Delete Bank Transaction Explanation

Tool to delete a bank transaction explanation in FreeAgent.

Delete Bill

Delete a bill by its FreeAgent identifier.

Delete Contact

Permanently delete a FreeAgent contact by ID.

Delete Estimate Item

Delete one line item from a FreeAgent estimate.

Delete Estimates Default Additional Text

Tool to delete default additional text for estimates in FreeAgent.

Delete Expense

Delete an expense by its FreeAgent identifier.

Delete Invoice

Permanently delete a FreeAgent invoice by ID.

Delete Journal Set

Delete a tagged FreeAgent journal set by its numeric ID.

Delete Note

Tool to delete a note by its ID.

Get Attachment

Retrieve any attachment's metadata and expiring content URLs by numeric ID.

Get Bill

Retrieve one FreeAgent bill by ID, including its line items and attachment metadata.

Get Category

Retrieve one FreeAgent accounting category by nominal code.

Get Contact

Retrieve one FreeAgent contact by its numeric ID.

Get Credit Note

Retrieve one FreeAgent credit note by its numeric ID, including line items.

Get Estimate

Retrieve one FreeAgent estimate by ID, including its estimate items.

Get Estimate Item

Retrieve one FreeAgent estimate line item by ID.

Get Expense

Retrieve one FreeAgent expense by ID, including its receipt attachment.

Get Invoice

Retrieve one FreeAgent invoice by its numeric ID, including line items.

Get Invoice Timeline

Tool to retrieve invoice timeline showing chronological record of invoice-related events.

Get Journal Set

Retrieve one FreeAgent journal set and its journal entries by numeric ID.

Get Mileage Settings

Tool to retrieve mileage settings including engine type/size options and reimbursement rates.

Get Opening Balances

Tool to retrieve the Opening Balances journal set for a company.

Get Personal Profile

Tool to retrieve the authenticated user's personal profile from FreeAgent.

Get Price List Item

Retrieve one FreeAgent price-list item by ID.

Get Project

Retrieve one FreeAgent project by its numeric ID.

Get the Opening Balances

Tool to retrieve the opening balances from the trial balance summary.

Get the P&L summary

Tool to retrieve the Profit and Loss summary for a specified period from FreeAgent.

Get Trial Balance Summary

Tool to get the trial balance summary from FreeAgent.

Get Balance Sheet

Tool to retrieve the balance sheet for a FreeAgent account.

Get Opening Balances

Tool to retrieve opening balances for the balance sheet from FreeAgent.

List Accounting Transactions

List a page of FreeAgent accounting transactions, optionally filtered by date range or nominal code.

List All CIS Bands

Tool to list all CIS (Construction Industry Scheme) bands for a company.

List All Expenses

List a page of FreeAgent expenses, optionally filtered by view type, date range, project, or last update timestamp.

List All Price List Items

List a page of FreeAgent price list items, optionally sorted by creation date, code, or update date.

List All Properties

Tool to list all properties in FreeAgent.

List All Recurring Invoices

Tool to retrieve a list of recurring invoices from FreeAgent.

List All Sales Tax Periods

Tool to list all sales tax periods for a company in FreeAgent.

List All Stock Items

List a page of FreeAgent stock items, with optional sorting by creation date, description, or update date and pagination controls.

List All Tasks

List a page of FreeAgent tasks with optional filtering by status, project, or update date, sorting, and pagination controls.

List All Timeslips

List a page of FreeAgent timeslips, with optional filtering by date range, user, project, task, billing status, or last update timestamp and pagination controls.

List All Users

Tool to list users in FreeAgent.

List Bank Accounts

Tool to list bank accounts in FreeAgent.

List Bank Feeds

Tool to list all bank feeds for a company.

List Bank Transaction Explanation Attachments

List file attachments for a FreeAgent bank transaction explanation.

List Bank Transactions

List a page of bank transactions for a specified FreeAgent bank account.

List Bills

Tool to retrieve a list of bills from FreeAgent.

List Business Categories

Tool to retrieve all available business categories from FreeAgent.

List Categories

Tool to retrieve all categories for the current FreeAgent company.

List Contacts

Tool to list contacts in FreeAgent.

List Credit Note Reconciliations

List a page of FreeAgent credit note reconciliations, optionally filtered by update timestamp or date range.

List Credit Notes

List FreeAgent credit notes with optional filtering by contact, project, status, or update time.

List EC MOSS Sales Tax Rates

Tool to retrieve EC VAT MOSS sales tax rates for a specific EU country and date.

List Estimates

Tool to list estimates in FreeAgent.

Get Default Estimates Additional Text

Tool to retrieve the default additional text for estimates.

List Final Accounts Reports

Tool to list final accounts reports for a company in FreeAgent.

List Hire Purchases

Tool to retrieve all hire purchases for the authorized FreeAgent account.

List Invoices

List ordinary FreeAgent invoices with filters and optional nested line items.

Get Default Additional Text

Tool to get the default additional text shown on all invoices.

List Notes

List notes for a specific contact or project, with pagination.

List Projects

Tool to list projects in FreeAgent.

List VAT Returns

Tool to list VAT returns for a company in FreeAgent.

Mark Invoice as Draft

Return a sent FreeAgent invoice to draft status.

Mark Invoice as Sent

Mark a draft invoice as sent without emailing it, or reopen a cancelled one.

Send Invoice Email

Email an existing invoice using explicit fields or an account template.

Show Tax Timeline

Tool to retrieve the company's tax timeline showing upcoming tax events and deadlines.

Update Bank Transaction Explanation

Tool to update a bank transaction explanation in FreeAgent.

Update Bill

Update a bill and create, update, or delete its line items.

Update Contact

Update mutable identity, contact, address, invoicing, and CIS fields.

Update Estimate Item

Update editable fields on an existing FreeAgent estimate item.

Update Estimates Default Additional Text

Tool to update the default additional text for estimates in FreeAgent.

Convert Estimate to Invoice

Tool to convert an estimate to an invoice in FreeAgent.

Update Expense

Tool to update an existing expense in FreeAgent.

Update Invoice

Update an invoice, including adding, changing, or deleting its line items.

Update Invoice Item

Update an existing invoice line item by its direct identifier.

Update Invoices Default Additional Text

Tool to update the default additional text shown on all invoices.

Convert Invoice to Credit Note

Tool to convert a draft negative invoice to a credit note in FreeAgent.

Update a Journal Set

Update a FreeAgent journal set's description, date, tag, or entries, including adding, modifying, or removing entries.

Update Note

Tool to update an existing note in FreeAgent.

Update Price List Item

Tool to update a price list item in FreeAgent.

Update Project

Update selected attributes of an existing FreeAgent project.

Update Personal Profile

Tool to update the authenticated user's personal profile in FreeAgent.

Upload a Bank Statement

Tool to upload a bank statement to FreeAgent.

FAQ

Frequently asked questions

Start with Freeagent.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Freeagent tool your agent needs.Free to start.

Start building