Skip to main content
Glama
nikan

elorus-mcp

by nikan
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

elorus-mcp

MCP server for the Elorus invoicing and accounting platform. Enables AI assistants to create invoices, manage contacts, and query financial data through natural language.

Setup

Prerequisites

  • Node.js 20+

  • An Elorus account with an API key and organization ID

Getting your credentials

  1. API key — open the Elorus web app → User Profile → API key

  2. Organization ID — open the Elorus web app → Settings → Organization → Organization ID

Install

npx elorus-mcp

Or clone and build locally:

git clone https://github.com/your-org/elorus-mcp
cd elorus-mcp
npm install && npm run build

Related MCP server: Billingo MCP Server

Claude Desktop configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "elorus": {
      "command": "npx",
      "args": ["elorus-mcp"],
      "env": {
        "ELORUS_API_KEY": "your-api-key",
        "ELORUS_ORG_ID": "your-org-id"
      }
    }
  }
}

Claude Code configuration

claude mcp add elorus -e ELORUS_API_KEY=your-api-key -e ELORUS_ORG_ID=your-org-id -- npx elorus-mcp

Local development

For local development, npm start loads environment variables from a .env file (via node --env-file) instead of requiring them to be passed inline. Copy .env.example to .env and fill in your credentials:

cp .env.example .env

Variable

Required

Description

ELORUS_API_KEY

Yes

Your Elorus API key

ELORUS_ORG_ID

Yes

Your Elorus organization ID

ELORUS_DEMO

No

Set to 1 to send X-Elorus-Demo: 1 on all requests (targets Elorus's demo/sandbox environment)

Note: if the server is launched by an MCP client config (e.g. Claude Desktop/Code) with its own env block, that env block takes precedence and .env is not read — only npm start invokes node --env-file=.env. Keep credentials in one place to avoid the two silently diverging.

Available tools

Contacts

Tool

Description

list_contacts

Search/filter contacts (clients, suppliers, or both) with pagination

get_contact

Fetch a contact by ID

create_contact

Create a client, supplier, or both

update_contact

Update fields on an existing contact

Invoices

Tool

Description

list_invoices

Filter invoices by status, client, date range

get_invoice

Fetch an invoice by ID

create_invoice

Create a sales invoice with line items and taxes

void_invoice

Void an invoice (excluded from financial reports, cannot be edited or paid)

send_invoice_email

Email an invoice to the client

export_invoice_pdf

Export an invoice as a PDF (returns a download URL)

Bills (supplier purchase invoices)

Tool

Description

list_bills

Filter supplier bills by supplier, status, or date range

get_bill

Fetch a bill by ID

create_bill

Create a supplier bill with line items and taxes

update_bill

Update fields on an existing bill

void_bill

Void a bill

Expenses

Tool

Description

list_expenses

Filter expense records by supplier, category, or date range

get_expense

Fetch an expense by ID

create_expense

Record a new business expense. Line items use expense_category/amount/description (not the invoice-style title/quantity/unit_value)

update_expense

Update fields on an existing expense

add_expense_attachment

Attach a file (e.g. a receipt or supplier invoice PDF) to an existing expense, given base64-encoded content

export_expense_pdf

Export an expense document as a PDF (returns a download URL)

Credit notes (issued to clients)

Tool

Description

list_credit_notes

Filter credit notes by client or date range

create_credit_note

Create a credit note to reduce or cancel an amount owed by a client

apply_credit_note

Apply a credit note against an open invoice

Supplier credits (received from suppliers)

Tool

Description

list_supplier_credits

Filter supplier credits by supplier or date range

create_supplier_credit

Record a credit note received from a supplier

apply_supplier_credit

Apply a supplier credit against an open bill

Cash receipts (payments received from clients)

Tool

Description

list_cash_receipts

Filter by client, invoice, or date range

record_cash_receipt

Record a payment received from a client, optionally linked to an invoice

export_cash_receipt_pdf

Export a cash receipt as a PDF (returns a download URL)

Cash payments (payments made to suppliers)

Tool

Description

list_cash_payments

Filter by supplier, bill, or date range

record_cash_payment

Record a payment made to a supplier, optionally linked to a bill

update_cash_payment

Update fields (e.g. title/bank reference) on an existing payment

delete_cash_payment

Permanently delete a payment made to a supplier

Products

Tool

Description

list_products

Search the products/services catalog

get_product

Fetch a product by ID

create_product

Add a product or service to the catalog

update_product

Update fields on an existing product or service

Notes and discussions

Tool

Description

list_private_notes

List internal notes on a resource (visible only to organization members)

create_private_note

Add an internal note to a resource

list_client_discussions

List client-visible discussion messages on a resource

create_client_discussion

Post a client-visible message on an invoice or cash receipt

Configuration lookups

Tool

Description

list_taxes

List tax rates configured in the organization

list_document_types

List document types (required for creating invoices, bills, credit notes, etc.)

list_units

List units of measurement (e.g. hours, pieces, kg)

list_expense_categories

List expense categories

MCP Resources

Read-only resources that return up to 100 of the most recent records as JSON, without needing a tool call:

Resource URI

Description

elorus://contacts

All contacts (clients and suppliers)

elorus://invoices

All sales invoices, most recent first

elorus://cashreceipts

All cash receipts (payments received from clients)

elorus://cashpayments

All cash payments (payments made to suppliers)

elorus://expenses

All expense records

elorus://bills

All supplier bills

elorus://products

All products and services in the catalog

Example prompts

  • "Create an invoice for Acme Corp for 5 hours of consulting at €150/hour with 24% VAT"

  • "What invoices are overdue this month?"

  • "Look up the contact for Elorus FC and show their details"

  • "Add a new product called 'Website Design' at €800 with standard VAT"

  • "Record a €45 office supplies expense from Staples"

  • "What bills are overdue from our suppliers?"

  • "Apply this credit note to invoice #1042"

Notes

  • All monetary values are strings (e.g. "1500.00") to avoid floating-point precision issues

  • Use list_taxes, list_document_types, list_units, and list_expense_categories to look up valid IDs before creating invoices, bills, expenses, credit notes, or products (bills don't use a document type — only invoices, credit notes, and estimates do)

  • Invoice/credit-note/supplier-credit line items use title/quantity/unit_value (or unit_total, depending on calculator_mode); bill line items also require expense_category; expense line items use a different shape: expense_category/amount/description

  • Elorus does not provide idempotency keys — query before creating to avoid duplicates

  • Pagination params: page (default 1) and page_size (default 20, max 100)

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nikan/elorus-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server