MCP Server#

Moloni ON provides a hosted MCP (Model Context Protocol) server that lets AI assistants work with your Moloni data using natural language. Instead of writing GraphQL yourself, you connect a compatible client — such as Claude — and it calls the API on your behalf through a curated set of tools (list customers, create a draft invoice, look up stock, and so on).

The server is a thin client of the Moloni ON GraphQL API: it exposes a subset of the API as tools, but holds no data of its own and never modifies anything the API wouldn't.

Endpoint#

The server is hosted at:

https://mcp.molonion.pt/mcp

You add this URL to your MCP client once; there is nothing to install or self-host.

How authentication works#

You never give the AI client your Moloni password. The first time you connect, your client opens a browser to sign in to Moloni ON (email, password, and 2FA if enabled) and authorize access. The client then receives a token it uses for subsequent requests, and refreshes it transparently. See Connecting a client for the step-by-step flow.

What you can do#

The tools cover the everyday invoicing workflow:

• Companies — list the companies you belong to and select the one to work in.
• Customers & products — search, read, and create.
• Documents — list and read documents, create drafts (invoices, receipts, credit notes, estimates, …), and email a document to a customer.
• Reference data — taxes, payment methods, and stock.
• Analysis — sales analysis.

See Available tools for the full list and the rules each tool follows.

Prerequisites#

• A Moloni ON account with at least one company.
• An MCP-capable client (for example, Claude desktop or Claude Code).