# Numio MCP

> Numio MCP is an MCP server for finance and payments. Read-only MCP connector that lets AI assistants query Numio financial reports. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://numio.es/integraciones/mcp/
- **MCP Registry name:** es.numio/numio
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [accounting and tax](https://ai-powered.com/categories/accounting-and-tax)
- **Listing updated:** 2026-11-21

## About

Numio's MCP server gives AI clients such as Claude, Codex, Cursor and VS Code read access to the financial data held in a Numio account. Once connected, an assistant can pull income statements, balance sheets, account-level balances and KPI comparisons across periods, using the same permissions the signed-in user already has.

Connection happens through a remote Streamable HTTP endpoint. Users can authorise with OAuth in the browser, or create an API key in Numio and send it as a bearer token header for clients that support custom headers. API keys can be given an expiry date and, for accounting firms, restricted to a single client.

The server is aimed at accounting firms managing several client companies and at small and medium businesses that want to ask questions about their own figures in plain language. Firms can review portfolio alerts and, depending on role, billing and profitability data.

## Features

- **Read-only financial access:** Assistants can query data but cannot change records, and the connection follows the permissions of the Numio account.
- **Income statement queries:** Revenue, expenses and margins can be requested for chosen periods and compared against earlier ones.
- **Balance and account detail:** Assets, liabilities, equity and balances by account can be retrieved from the ledger.
- **Portfolio alerts for firms:** Accounting firms can review client lists and alerts through the assistant, subject to their role.
- **OAuth or API key sign-in:** Browser-based OAuth authorisation is offered, with bearer API keys as an alternative for compatible clients.
- **Revocable connections:** OAuth connections and API keys are managed and revoked separately from the Numio settings page.

## Good for

- Compare quarterly revenue against the same quarter of the previous year in euros and percentages
- Prepare a client meeting by summarising a balance sheet and spotting accounts that moved most
- Review alerts across a client portfolio before a weekly accounts meeting
- Check margins and expenses for a business without opening the accounting software

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http numio https://app.numio.es/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.numio.es/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "numio": {
      "url": "https://app.numio.es/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "numio": {
      "type": "http",
      "url": "https://app.numio.es/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "numio": {
      "serverUrl": "https://app.numio.es/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://app.numio.es/mcp
```

Enter a Name (for example "Numio MCP"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "numio": {
      "type": "http",
      "url": "https://app.numio.es/mcp"
    }
  }
}
```

## FAQ

### Can the assistant change data in Numio?

No. The connection is read-only and is limited to queries.

### Do I need an API key to connect?

No. With OAuth you only authorise the connection in the browser. An API key is an alternative for clients that can send an Authorization header.

### How do I disconnect an assistant?

Open the Numio settings and revoke the OAuth connection in the MCP section. If you used an API key, revoke it there and remove it from the client configuration.

### How do I add Numio MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http numio https://app.numio.es/mcp

### What are the best alternatives to Numio MCP?

The closest alternatives to Numio MCP are BankMCP™, Uuno, Xero, Synci and Money Magician.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [BankMCP™](https://ai-powered.com/mcp/bankmcptm): BankMCP™ is an open-source MCP server for finance and payments.
- [Uuno](https://ai-powered.com/mcp/uuno): Uuno is an MCP server for finance and payments.
- [Xero](https://ai-powered.com/mcp/xero-3): Xero is an open-source MCP server for finance and payments.
- [Synci](https://ai-powered.com/mcp/synci): Synci is a freemium MCP server for finance and payments.
- [Money Magician](https://ai-powered.com/mcp/money-magician): Money Magician is an MCP server for finance and payments.
- [Portfellow](https://ai-powered.com/mcp/portfellow): Portfellow is a freemium MCP server for finance and payments.
- [ÚčtoMost Money S3 MCP](https://ai-powered.com/mcp/uctomost-money-s3-mcp): ÚčtoMost Money S3 MCP is an MCP server for cloud and infrastructure.
- [Banco MCP](https://ai-powered.com/mcp/banco-mcp): Banco MCP is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/numio-mcp
