# Elorus — MCP server on mcp.ai
> Connect your Elorus account and use 13 tools for proposals and invoices straight from your AI agent. Connect with your own API key. Elorus is an online invoicing and time-tracking software designed for freelancers and small businesses to manage their finances and projects efficiently.

By: mcp.ai · official
Page: https://mcp.ai/elorus

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_elorus?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/elorus/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/elorus/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/elorus/skill.md
Postman collection (v2.1): https://mcp.ai/elorus/postman.json

## Tools
- elorus_create_invoice(kind: string, tags?: string[], items: object[], notes?: string, discount?: number, client_id: string, series_id: string, issue_date: string, currency_id: string, payable_date?: string, document_number?: string, contact_address_id?: string) — Creates a new invoice or receipt in Elorus. Invoices are automatically saved as drafts by default and use the 'initial' calculation mode (amounts specified before taxes). Required: issue_date, currenc
- elorus_create_product(code?: string, sales?: boolean, stock?: string, title: string, active?: boolean, manage?: boolean, custom_id?: string, purchases?: boolean, sale_taxes?: string[], sale_value?: string, taric_code?: string, description?: string, unit_measure?: string, purchase_taxes?: string[], purchase_value?: string) — Create a new product or service in Elorus. Use this to add items to your product catalog with pricing, tax settings, and inventory management options.
- elorus_email_invoice(cc?: string[], bcc?: string[], contacts: integer[], email_body: string, invoice_id: integer, email_subject: string) — Tool to email an existing invoice to specified contacts. Use after generating an invoice and obtaining contact IDs.
- elorus_get_bills(page?: integer, period?: string, search?: string, status?: string, ordering?: string, supplier?: string, page_size?: integer, period_to?: string, period_from?: string) — Retrieve a paginated list of bills (expenses/purchases) from Elorus. Supports filtering by supplier, date range, status, and text search. Use this to view and manage bills created in your organization
- elorus_get_contacts(page?: integer, search?: string, order_by?: string, statuses?: string[], is_company?: boolean, sort_order?: string, contact_ids?: integer[], custom_fields?: object, show_archived?: boolean, items_per_page?: integer) — Tool to retrieve a list of contacts. Use after authentication to fetch contacts in batches. Example: 'List page 2 of active company contacts sorted by name.'
- elorus_get_credit_notes(page?: integer, contact?: integer, currency?: string, page_size?: integer, issued_on__gte?: string, issued_on__lte?: string) — Tool to retrieve a list of credit notes. Use when you need to fetch credit notes filtered by page, contact, date range, or currency.
- elorus_get_email_templates(page?: integer, page_size?: integer) — Tool to retrieve a list of email templates. Use when you need to fetch and page through existing templates in the organization.
- elorus_get_estimates(page?: integer, page_size?: integer) — Tool to retrieve a list of estimates. Use when you need to list estimates with pagination after creation.
- elorus_get_invoices(page?: integer, tags?: string, number?: string, status?: string, contact?: string, currency?: string, ordering?: string, page_size?: integer, due_date__gte?: string, due_date__lte?: string, issue_date__gte?: string, issue_date__lte?: string) — Retrieves a paginated list of invoices from Elorus with flexible filtering options. Use this tool to: - List all invoices or filter by client, status, date ranges, currency, or tags - Paginate through
- elorus_get_products(page?: integer, sort?: string, limit?: integer, fields?: string, filter?: string) — Tool to retrieve a list of products/services with optional filtering, sorting, and pagination. Use when you need to fetch products for reports, UI lists, or inventory management.
- elorus_get_taxes(q?: string, page?: integer, per_page?: integer) — Tool to retrieve a list of taxes. Use after authentication to list taxes with optional filters.
- elorus_get_templates(page?: integer, per_page?: integer) — Retrieves document templates used for formatting invoices, estimates, credit notes, and other business documents in Elorus. Templates define the visual layout, language, company branding, and default 
- elorus_update_contact(id: string, email?: object[], phones?: object[], company?: string, addresses?: object[], custom_id?: string, is_client?: boolean, last_name?: string, first_name?: string, profession?: string, vat_number?: string, is_supplier?: boolean, default_language?: string, default_currency_code?: string) — Update an existing contact in Elorus by ID. Allows modifying contact details such as name, company, addresses, and communication preferences. Use this tool when you need to: - Update contact informati

## Example prompts
- "What can I do in Elorus?"
- "Show me a summary of my Elorus account"

## Links
Docs: https://mcp.ai/docs/mcps/elorus
Website: https://mcp.ai/mcps/elorus