How to integrate Elorus MCP with Atomic Agent

Connect Atomic Agent to Elorus MCP. Create a new invoice for acme corp, list all unpaid bills from last month, and more using natural language, with authentication handled for you.

Elorus logoElorus
Api Key

Elorus is an online invoicing and time-tracking software for freelancers and small businesses. Easily manage finances, bill clients, and track work 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,700+ apps through Composio, including Elorus.

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

How Atomic Agent connects to Elorus

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

The Elorus MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Elorus account. It provides structured and secure access to your invoicing, billing, and time-tracking tools, so your agent can perform actions like creating invoices, managing contacts, tracking estimates, and sending billing communications on your behalf.

  • Automated invoice creation and delivery: Instruct your agent to generate new invoices, fill in all necessary details, and instantly email them to clients or contacts with just a prompt.
  • Comprehensive contact management: Ask your agent to fetch, list, and organize your business contacts, so you can easily keep your client database up to date or find specific clients in seconds.
  • Dynamic bills and expenses tracking: Let your agent retrieve and manage lists of bills and expenses, helping you stay on top of accounts payable and overall financial health.
  • Flexible product and service catalog management: Direct your agent to create new products or services, update details, or fetch lists of items for invoicing and inventory purposes.
  • Estimates and credit notes retrieval: Have your agent pull up estimates or credit notes with filters for date, contact, or status—ideal for monitoring ongoing deals and financial adjustments.

Use Elorus from Atomic Agent

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

Create Expense

Create an Elorus expense from categorized line items.

Create Invoice

Creates a new invoice or receipt in Elorus.

CREATE_PRODUCT

Create a new product or service in Elorus.

Delete Invoice

Permanently delete a draft invoice.

Email Invoice

Tool to email an existing invoice to specified contacts.

Get Bills

Retrieve a paginated list of bills (expenses/purchases) from Elorus.

Get Contact

Retrieve all current details for one Elorus contact by ID.

Get Contacts

Tool to retrieve a list of contacts.

Get Credit Notes

Tool to retrieve a list of credit notes.

Get Email Templates

Tool to retrieve a list of email templates.

Get Estimates

Tool to retrieve a list of estimates.

Get Expense

Retrieve all current details for one Elorus expense.

List Expense Attachments

List one Elorus expense's attachments, one page at a time.

List Expenses

Search and filter expenses and return one paginated page of summaries.

Get Invoice

Retrieve all current details for one Elorus invoice.

Get Invoices

Retrieves a paginated list of invoices from Elorus with flexible filtering options.

Get Products

Tool to retrieve a list of products/services with optional filtering, sorting, and pagination.

Get Taxes

Tool to retrieve a list of taxes.

Get Templates

Retrieves document templates used for formatting invoices, estimates, credit notes, and other business documents in Elorus.

Update Contact

Update an existing contact in Elorus by ID.

Update Expense

Replace an Elorus expense's editable details and complete line-item set.

FAQ

Frequently asked questions

Start with Elorus.It takes 30 seconds.

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

Start building