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.

21 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,500+ 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.

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 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.

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 Sales Invoice

Tool to get a single sales invoice by ID.

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 Sales Invoices

Tool to list all sales invoices in an 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.

FAQ

Frequently asked questions

With a standalone Moneybird MCP server, the agents and LLMs can only access a fixed set of Moneybird tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Moneybird and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Moneybird tools.

Yes, absolutely. You can configure which Moneybird scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Moneybird data and credentials are handled as safely as possible.

Start with Moneybird.It takes 30 seconds.

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

Start building