How to integrate Moneybird MCP with Atomic Agent

Connect Atomic Agent to Moneybird MCP. Create a sales invoice for a new client, filter contacts added this month, and more using natural language, with authentication handled for you.

Moneybird logoMoneybird
Oauth2Api Key

Moneybird is an online invoicing and accounting platform for small businesses and freelancers. It streamlines billing, expense management, and financial reporting—all in one place.

32 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Moneybird.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Moneybird account. See the Atomic Agent documentation for installation instructions.

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

Also integrate Moneybird with

How Atomic Agent connects to Moneybird

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Moneybird to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Moneybird. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Moneybird account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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

The Moneybird MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Moneybird account. It provides structured and secure access to your invoicing and accounting data, so your agent can perform actions like creating contacts, sending invoices, managing notes, and keeping your financial records up to date on your behalf.

  • Automated contact creation and management: Instantly add new clients or companies, update existing records, archive unused contacts, or remove outdated information—without manual entry.
  • Easy invoice generation: Direct your agent to create detailed sales invoices for any contact, including custom line items, for fast and accurate billing.
  • Contact note and to-do tracking: Record comments, assign to-dos, and manage notes on contacts, ensuring follow-ups and client history are always at your fingertips.
  • Contact filtering and segmentation: Effortlessly filter and retrieve contacts based on criteria like creation date or name, making it easy to target communications or review segments of your client base.
  • Comprehensive contact person management: Add or remove individual contact persons linked to organizations, keeping your records detailed and up to date for every client relationship.

Use Moneybird from Atomic Agent

With your account connected, ask Atomic Agent to work with Moneybird in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

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

Add Note to Contact

Tool to add a note or to-do to a contact.

Archive Contact

Tool to archive a contact.

Create Moneybird Contact

Tool to create a new contact in Moneybird.

Create Contact Person

Tool to create a new contact person.

Create External Sales Invoice Payment

Register a payment against a Moneybird external sales invoice.

Create Sales Invoice

Tool to create a new sales invoice.

Delete Contact

Tool to delete a contact.

Delete Contact Note

Tool to delete a note from a contact.

Delete Contact Person

Tool to delete a contact person from a contact.

Delete Document

Delete a Moneybird accounting document from a supported family.

Download Document Attachment

Download an attachment from a supported Moneybird accounting document.

Filter Contacts

Tool to filter contacts.

Get Additional Charges

Tool to get additional charges for a contact.

Get Contact

Tool to retrieve all information about a specific contact by ID.

Get Contact by Customer ID

Tool to retrieve full contact details by customer ID.

Get Contact Person

Tool to get all information about a contact person.

Get Document

Retrieve an accounting document by its family and ID.

Get External Sales Invoice

Retrieve an external sales invoice by its ID.

Get Sales Invoice

Tool to get a single sales invoice by ID.

Get Tax Report

Get tax figures for a Moneybird administration and period.

List Administrations

Tool to list all administrations accessible by the authenticated user.

List Contacts Synchronization

Tool to list all contact IDs and versions for synchronization.

List Financial Accounts

List active financial accounts in a Moneybird administration.

List Ledger Accounts

List every ledger account in a Moneybird administration.

List Purchase Invoices

List one page of incoming purchase invoices for an administration.

List Sales Invoices

List sales invoice overviews for an administration, with optional filtering and pagination.

List Tax Rates

List one page of tax rates for a Moneybird administration.

Request Payments Mandate URL

Tool to request a URL for setting up a Payments mandate.

Update Contact

Tool to update a contact.

Update Contact Person

Tool to update a contact person.

Update Sales Invoice

Tool to update an existing sales invoice by ID.

Upload Document Attachment

Upload a file attachment to a Moneybird accounting document.

FAQ

Frequently asked questions

Start with Moneybird.It takes 30 seconds.

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

Start building