How to integrate bexio MCP with Atomic Agent

Connect Atomic Agent to bexio MCP. List unpaid bexio invoices due this month, create a bexio contact for new customer, and more using natural language, with authentication handled for you.

bexio logobexio
Oauth2Bearer Token

bexio is a Swiss business management platform for accounting, invoicing, contacts, projects, banking, expenses, and payroll. It brings core business operations into one connected workspace.

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

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 bexio 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 bexio with

How Atomic Agent connects to bexio

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 bexio 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 bexio. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your bexio 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 bexio MCP server, and what's possible with it?

The bexio MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your bexio account. It provides structured and secure access to invoicing, billing, contacts, projects, expenses, files, and accounting workflows, so your agent can create invoices, record payments, manage contacts, update projects, and handle expenses on your behalf.

  • Invoice and quote management: Have your agent create, copy, cancel, and generate invoices from orders or quotes, accept or copy quotes, and create invoice reminders.
  • Billing and payment workflows: Let the agent create bills, expenses, invoice payments, outgoing payments, and manual accounting entries, or cancel invoice payments when needed.
  • Contact and customer records: Direct your agent to create individual or bulk contacts, contact groups, additional addresses, and relationships between contacts.
  • Project coordination: Instruct your agent to create milestones and comments, archive projects, and create orders, deliveries, or invoices connected to project work.
  • Business files and team records: Have your agent create files, notes, employees, employee absences, items, and item positions in bexio.

Use bexio from Atomic Agent

With your account connected, ask Atomic Agent to work with bexio 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 bexio action and event your agent gets out of the box.

Accept Quote

Accept a quote.

Archive Project

Archive a project.

Cancel Invoice

Cancel an invoice.

Cancel Payment

Cancel a payment.

Check Bill Document Number

Check whether a bill document number is available.

Check Expense Document Number

Check whether an expense document number is available.

Copy Invoice

Copy a invoice.

Copy Quote

Copy a quote.

Create Additional Address

Create additional address.

Create Bill

Create new Bill.

Create Business Activity

Create business activity.

Create Calendar Year

Create calendar year.

Create Comment

Create a comment on a quote, order, or invoice.

Create Contact

Create contact.

Create Contact Group

Create contact group.

Create Contact Relation

Create contact relation.

Create Contacts Bulk

Bulk create contacts.

Create Country

Create country.

Create Currency

Create a currency.

Create Default Position

Create a default position on a quote, order, or invoice.

Create Delivery From Order

Create delivery from order.

Create Discount Position

Create a discount position.

Create Employee

Create employee.

Create Employee Absence

Create absence for employee.

Create Expense

Create new Expense.

Create Fictional User

Create a fictional user.

Create File

Create new file.

Create Invoice

Create invoice.

Create Invoice From Order

Create invoice from order.

Create Invoice From Quote

Create invoice from quote.

Create Invoice Payment

Create payment.

Create Invoice Reminder

Create reminder.

Create Item

Create item.

Create Item Position

Create an item position on a quote, order, or invoice.

Create Manual Entry

Create manual entry.

Create Milestone

Create milestone.

Create Note

Create note.

Create Order

Create order.

Create Order From Quote

Create order from quote.

Create Outgoing Payment

Create new Outgoing Payment.

Create Pagebreak Position

Create a pagebreak position.

Create Payment

Create a banking payment.

Create Project

Create project.

Create Purchase Order

Create a purchase order.

Create Quote

Create quote.

Create Salutation

Create salutation.

Create Subposition Position

Create a sub position on a quote, order or invoice.

Create Subtotal Position

Create a subtotal position.

Create Task

Create task.

Create Text Position

Create a text position on a quote, order, or invoice.

Create Timesheet

Create a timesheet with range-based time tracking.

Create Title

Create title.

Create Unit

Create unit.

Create Work Package

Create work package.

Decline Quote

Decline a quote.

Delete Additional Address

Delete an additional address.

Delete Bill

Delete Bill.

Delete Contact

Delete a contact.

Delete Contact Group

Delete a contact group.

Delete Contact Relation

Delete a contact relation.

Delete Country

Delete a country.

Delete Currency

Delete a currency.

Delete Default Position

Delete a default position from a quote, order, or invoice.

Delete Discount Position

Delete a discount position.

Delete Employee Absence

Deleting employee absence with given id.

Delete Expense

Delete Expense.

Delete Fictional User

Delete a fictional user.

Delete File

Delete a existing file.

Delete Invoice

Delete an invoice.

Delete Invoice Payment

Delete a payment.

Delete Invoice Reminder

Delete a reminder.

Delete Item

Delete an item.

Delete Item Position

Delete an item position from a quote, order, or invoice.

Delete Manual Compound Entry File

Delete connection between file and manual compound entry.

Delete Manual Entry

Delete manual entry.

Delete Manual Entry File

Delete connection between file and manual entry line.

Delete Milestone

Delete a milestone.

Delete Note

Delete a note.

Delete Order

Delete an order.

Delete Order Repetition

Delete the repetition for a specified order.

Delete Outgoing Payment

Delete Outgoing Payment.

Delete Pagebreak Position

Delete a pagebreak position.

Delete Payment

Delete a banking payment.

Delete Project

Delete a project.

Delete Purchase Order

Delete a purchase order.

Delete Quote

Delete a quote.

Delete Salutation

Delete a salutation.

Delete Subposition Position

Delete a sub position from a quote, order or invoice.

Delete Subtotal Position

Delete a subtotal position.

Delete Task

Delete a task.

Delete Tax

Delete a tax.

Delete Text Position

Delete a text position from a quote, order, or invoice.

Delete Timesheet

Delete a timesheet.

Delete Title

Delete a title.

Delete Unit

Delete a unit.

Delete Work Package

Delete a work package.

Download File

Download file.

Download Paystub Pdf

Download paystub pdf for employee for given month.

Duplicate Bill

Create a duplicate of the selected bill.

Duplicate Expense

Create a duplicate of the selected expense.

Get Additional Address

Return the additional address.

Get Bank Account

Return the single bank account.

Get Bill

Return Bill.

Get Business Year

Return the business year.

Get Calendar Year

Return the calendar year.

Get Comment

Return a comment on a quote, order, or invoice.

Get Company Profile

Return company profile.

Get Contact

Return the contact.

Get Contact Group

Return the contact group.

Get Contact Relation

Return the contact relation.

Get Country

Return the country.

Get Currency

Return the currency.

Get Current User

Return the authenticated user.

Get Default Position

Return a default position on a quote, order, or invoice.

Get Delivery

Return the delivery.

Get Discount Position

Return the discount position.

Get Employee

Retrieve a single employee on a specific date.

Get Employee Absence

Retrieving absence for employee with given absence id.

Get Expense

Return Expense.

Get Fictional User

Return the fictional User.

Get File

Return metadata for a single file; use Download File to retrieve its content.

Get File Usage

Return file usage.

Get Invoice

Return the invoice.

Get Invoice Payment

Return the payment.

Get Invoice Pdf

Return PDF.

Get Invoice Reminder

Return the reminder.

Get Invoice Reminder Pdf

Return reminder PDF.

Get Item

Return the item.

Get Item Position

Return an item position from a quote, order, or invoice.

Get Manual Compound Entry File

Return file of manual compound entry.

Get Manual Entry File

Return file of manual entry line.

Get Milestone

Return the milestone.

Get Next Reference Number

Return the suggested reference number for the next manual accounting entry.

Get Note

Return the note.

Get Order

Return the order.

Get Order Pdf

Return an order PDF as a JSON object containing file metadata and base64-encoded content.

Get Order Repetition

Return the repetition settings for a specified order.

Get Outgoing Payment

Return Outgoing Payment.

Get Pagebreak Position

Return the pagebreak position.

Get Payment

Return a banking payment.

Get Permissions

Return access information of logged in user.

Get Project

Return the project.

Get Purchase Order

Return the single purchase order.

Get Quote

Return the quote.

Get Quote Pdf

Return a quote PDF with its content encoded in base64 and associated file metadata.

Get Salutation

Return the salutation.

Get Subposition Position

Return a sub position from a quote, order or invoice.

Get Subtotal Position

Return the subtotal position.

Get Task

Return the task.

Get Tax

Return the tax.

Get Text Position

Return a text position from a quote, order, or invoice.

Get Timesheet

Return the timesheet.

Get Title

Return the title.

Get Unit

Return the unit.

Get User

Return the user.

Get Vat Period

Return the vat period.

Get Work Package

Return the work package.

Issue Delivery

Issue a delivery.

Issue Invoice

Issue an invoice.

Issue Quote

Issue a quote.

List Account Groups

Return one page of account groups.

List Accounts

Return one page of accounts.

List Additional Addresses

Return one page of additional addresses for a specified contact.

List Bank Accounts

Return one page of bank accounts.

List Bills

Return Bills, one page at a time.

List Business Activities

Return one page of business activities.

List Business Years

Return one page of business years.

List Calendar Years

Return one page of calendar years.

List Comments

Return one page of comments on a quote, order, or invoice.

List Communication Types

Return one page of communication types.

List Company Profile

Return company profiles.

List Contact Groups

Return one page of contact groups.

List Contact Relations

Return one page of contact relations.

List Contacts

Return one page of contacts.

List Contact Sectors

Return one page of contact sectors.

List Countries

Return one page of countries.

List Currencies

Return one page of currencies.

List Currency Codes

Return possible currency codes.

List Default Positions

Return one page of default positions.

List Deliveries

Return one page of deliveries.

List Discount Positions

Return one page of discount positions.

List Document Settings

List document settings.

List Document Template

List document templates.

List Employee Absences

Retrieving absences of employee for given year.

List Employees

Retrieves all active employees.

List Exchange Rates For Currency

Return exchange rates for a specified currency, optionally for a validity date.

List Expenses

Return Expenses, one page at a time.

List Fictional Users

Return one page of fictional users.

List Files

Return one page of files.

List Invoice Payments

Return one page of payments.

List Invoice Reminders

List reminders for an invoice.

List Invoices

Return one page of invoices.

List Item Positions

Return one page of item positions for a quote, order, or invoice.

List Items

Return one page of items.

List Journal Entries

Journal, one page at a time.

List Languages

Return one page of languages.

List Manual Compound Entry Files

Return files of manual compound entry, one page at a time.

List Manual Entries

Return one page of manual entries.

List Manual Entry Files

Return files of manual entry line, one page at a time.

List Milestones

Return one page of milestones for a specified project.

List Notes

Return one page of notes.

List Orders

Return one page of orders.

List Outgoing Payments

Retrieve outgoing payments for a specified bill, one page at a time.

List Pagebreak Positions

Return one page of pagebreak positions.

List Payments

Return one page of payments.

List Payment Types

Return one page of payment types.

List Projects

Return one page of projects.

List Project Status

Project status.

List Project Type

Project types.

List Purchase Orders

Return one page of purchase orders.

List Quotes

Return one page of quotes.

List Salutations

Return one page of salutations.

List Stock Areas

Return one page of stock areas.

List Stock Locations

Return one page of stock locations.

List Subposition Positions

Return one page of sub positions.

List Subtotal Positions

Return one page of subtotal positions.

List Task Priorities

Task priorities, one page at a time.

List Tasks

Return one page of tasks.

List Task Status

Task status, one page at a time.

List Taxes

Return one page of taxes.

List Text Positions

Return one page of text positions for a quote, order, or invoice.

List Timesheets

Return one page of timesheets.

List Time Sheet Status

Timesheet status, one page at a time.

List Titles

Return one page of titles.

List Units

Return one page of units.

List Users

Return one page of users.

List Vat Periods

Return one page of vat periods.

List Work Packages

Return one page of work packages.

Mark As Sent Invoice

Mark invoice as sent.

Mark As Sent Invoice Reminder

Mark reminder as sent.

Mark As Sent Quote

Mark quote as sent.

Mark As Unsent Invoice Reminder

Mark reminder as unsent.

Preview File

Return file preview.

Reissue Quote

Reissue a quote.

Restore Contact

Restore a contact.

Revert Issue Invoice

Sets issued invoice to draft.

Revert Issue Quote

Revert issue a quote.

Search Accounts

Search Accounts, one page at a time.

Search Additional Addresses

Search additional addresses for a specified contact, one page at a time.

Search Business Activities

Search business activities, one page at a time.

Search Calendar Years

Search calendar years, one page at a time.

Search Communication Types

Search communication types, one page at a time.

Search Contact

Search contacts, one page at a time.

Search Contact Groups

Search contact groups, one page at a time.

Search Contact Relations

Search contact relations, one page at a time.

Search Contact Sectors

Search contact sectors, one page at a time.

Search Countries

Search countries, one page at a time.

Search Files

Search files, one page at a time.

Search Invoices

Search invoices, one page at a time.

Search Items

Search items, one page at a time.

Search Languages

Search languages, one page at a time.

Search Notes

Search notes, one page at a time.

Search Orders

Search orders, one page at a time.

Search Payment Types

Search payment types, one page at a time.

Search Projects

Search projects, one page at a time.

Search Quotes

Search quotes, one page at a time.

Search Reminders

Search reminders for a specified invoice using filters.

Search Salutations

Search salutations, one page at a time.

Search Stock Areas

Search stock areas, one page at a time.

Search Stock Locations

Search stock locations, one page at a time.

Search Tasks

Search tasks, one page at a time.

Search Timesheets

Search timesheets, one page at a time.

Search Titles

Search titles, one page at a time.

Search Units

Search units, one page at a time.

Send Invoice

Send an invoice.

Send Invoice Reminder

Send an invoice reminder.

Send Quote

Send a quote.

Unarchive Project

Unarchive a project.

Update Additional Address

Edit an additional address.

Update Bill

Update Bill.

Update Bill Booking Status

Update a bill's booking status to DRAFT or BOOKED.

Update Contact

Edit a contact.

Update Contact Group

Edit a contact group.

Update Contact Relation

Edit a contact relation.

Update Country

Edit a country.

Update Currency

Update the round factor of a currency.

Update Default Position

Edit a default position on a quote, order, or invoice.

Update Discount Position

Edit a discount position.

Update Employee

Update employee.

Update Employee Absence

Updating existing absence.

Update Expense

Update Expense.

Update Expense Booking Status

Update Expense status.

Update Fictional User

Update a fictional User.

Update File

Update an existing file's metadata, including its name, archived state, or source type.

Update Invoice

Edit an invoice.

Update Item

Edit an item.

Update Item Position

Edit an item position on a quote, order, or invoice.

Update Manual Entry

Update manual entry.

Update Milestone

Edit a milestone.

Update Note

Edit a note.

Update Order

Edit an order.

Update Order Repetition

Edit an order's repetition.

Update Outgoing Payment

Edit Outgoing Payment.

Update Pagebreak Position

Edit a pagebreak position.

Update Payment

Update a payment.

Update Project

Edit a project.

Update Purchase Order

Update a single purchase order.

Update Quote

Edit a quote.

Update Salutation

Edit a salutation.

Update Subposition Position

Edit a sub position on a quote, order or invoice.

Update Subtotal Position

Edit a subtotal position.

Update Task

Edit a task.

Update Text Position

Edit a text position on a quote, order, or invoice.

Update Timesheet

Edit a timesheet with range-based time tracking.

Update Title

Edit a title.

Update Unit

Edit a unit.

Update Work Package

Edit a work package.

Upload Manual Compound Entry File

Add file to manual compound entry.

Upload Manual Entry File

Add file to manual entry line.

FAQ

Frequently asked questions

Start with bexio.It takes 30 seconds.

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

Start building