# FISCAi Octopus API Connector

> FISCAi Octopus API Connector is an open-source MCP server for accounting and tax. Read-only MCP server giving AI clients access to Octopus accounting data for Belgian. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Self-hosted, API
- **Repository:** https://github.com/mnralci/fiscai-octopus-api-connector
- **MCP Registry name:** io.github.MnrAlci/fiscai-octopus-api-connector
- **Categories:** [accounting and tax](https://ai-powered.com/categories/accounting-and-tax)
- **Listing updated:** 2026-11-21

## About

Connects AI assistants such as Grok Bot, Claude, Cursor and Copilot to the Octopus accounting REST API, letting them read fiscal years, journals, chart of accounts, balances, booking lines, relations and open items. Because Octopus limits daily calls per endpoint, the connector caches responses and syncs only changed records through the modified-since endpoints, and it counts calls before sending them.

On top of the raw API it builds a trial balance, ageing of open items, MAR key figures and a year-end dossier transfer package with checksums for the next accountant. Exports are available as CSV, JSON, Excel and Parquet. It runs locally over stdio, with credentials kept in memory and optional encryption of the local cache.

It is aimed at Belgian bookkeepers and accountants working with the MAR chart of accounts and Belgian VAT. It is Apache 2.0 licensed and is not endorsed by Octopus.

## Features

- **Read-only Octopus access:** Exposes dossiers, journals, balances, booking lines and reports to MCP clients without write access by default.
- **Daily limit management:** Counts each API call against Octopus daily quotas and refuses calls once the limit is reached.
- **Local caching and sync:** Stores responses locally and updates them through modified-since endpoints, optionally encrypted on disk.
- **Trial balance and analyses:** Builds a trial balance, ageing of open items and MAR key figures, which the API does not provide directly.
- **Dossier transfer package:** Produces a per-fiscal-year transfer bundle with control checks and SHA-256 manifest, resumable after limits.
- **Multi-format exports:** Exports data to CSV, JSON, Excel and Parquet for spreadsheets, databases and notebooks.

## Good for

- Reviewing a client's trial balance for a fiscal year through an AI assistant
- Tracking ageing of customer and supplier open items
- Preparing meeting notes and draft reminder e-mails for recurring VAT and annual accounts obligations
- Handing over a client dossier to a new accountant with a verified transfer package
- Exporting Octopus bookings to Excel or Power BI for analysis

## Install

### Claude Code (Terminal)

```sh
claude mcp add fiscai-octopus-api-connector --env OCTOPUS_SOFTWARE_HOUSE_UUID='<OCTOPUS_SOFTWARE_HOUSE_UUID>' --env OCTOPUS_USER='<OCTOPUS_USER>' --env OCTOPUS_PASSWORD='<OCTOPUS_PASSWORD>' --env OCTOPUS_CACHE_KEY='<OCTOPUS_CACHE_KEY>' -- npx -y https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fiscai-octopus-api-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
      ],
      "env": {
        "OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
        "OCTOPUS_USER": "<OCTOPUS_USER>",
        "OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
        "OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fiscai-octopus-api-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
      ],
      "env": {
        "OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
        "OCTOPUS_USER": "<OCTOPUS_USER>",
        "OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
        "OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "fiscai-octopus-api-connector": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
      ],
      "env": {
        "OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
        "OCTOPUS_USER": "<OCTOPUS_USER>",
        "OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
        "OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fiscai-octopus-api-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
      ],
      "env": {
        "OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
        "OCTOPUS_USER": "<OCTOPUS_USER>",
        "OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
        "OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fiscai-octopus-api-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb"
      ],
      "env": {
        "OCTOPUS_SOFTWARE_HOUSE_UUID": "<OCTOPUS_SOFTWARE_HOUSE_UUID>",
        "OCTOPUS_USER": "<OCTOPUS_USER>",
        "OCTOPUS_PASSWORD": "<OCTOPUS_PASSWORD>",
        "OCTOPUS_CACHE_KEY": "<OCTOPUS_CACHE_KEY>"
      }
    }
  }
}
```

## FAQ

### Can the connector change data in Octopus?

Write tools are off by default and only appear when OCTOPUS_WRITE_ENABLED is set to true. Even then, writes are proposals that need a confirmation code and a daily maximum. Delete operations are not offered.

### Which software does FISCAi Octopus API Connector run in?

It runs as a local stdio MCP server and works with Grok Bot, Claude, Cursor, Windsurf and VS Code Copilot, plus a command-line interface.

### Is there a hosted plan or a cost?

The project is open source under Apache 2.0 and runs on your own computer. It does not use the paid Octopus Management API.

### Which accounting rules does FISCAi Octopus API Connector follow?

It is built for the Belgian chart of accounts (MAR) and Belgian VAT rules. Use outside Belgium requires checking local rules yourself.

### Has FISCAi Octopus API Connector been tested with a live Octopus dossier?

Not yet. It has been tested against a mocked API built from the official specification, as Octopus has no sandbox.

### How do I add FISCAi Octopus API Connector to Claude Code?

Run this command in your terminal: claude mcp add fiscai-octopus-api-connector --env OCTOPUS_SOFTWARE_HOUSE_UUID='<OCTOPUS_SOFTWARE_HOUSE_UUID>' --env OCTOPUS_USER='<OCTOPUS_USER>' --env OCTOPUS_PASSWORD='<OCTOPUS_PASSWORD>' --env OCTOPUS_CACHE_KEY='<OCTOPUS_CACHE_KEY>' -- npx -y https://github.com/MnrAlci/fiscai-octopus-api-connector/releases/download/v1.0.0/fiscai-octopus-api-connector-1.0.0.mcpb

### What are the best alternatives to FISCAi Octopus API Connector?

The closest alternatives to FISCAi Octopus API Connector are FISCAi Yuki API Connector, Nationale Boekhoudmaatschappij, Praat met je Boekhouding (Chat with your Books), Cijferlink and PolyAccounts accounting.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [FISCAi Yuki API Connector](https://ai-powered.com/mcp/fiscai-yuki-api-connector): FISCAi Yuki API Connector is an open-source MCP server for accounting and tax.
- [Nationale Boekhoudmaatschappij](https://ai-powered.com/mcp/nationale-boekhoudmaatschappij): Nationale Boekhoudmaatschappij is an MCP server for accounting and tax.
- [Praat met je Boekhouding (Chat with your Books)](https://ai-powered.com/mcp/praat-met-je-boekhouding-chat-with-your-books): Praat met je Boekhouding (Chat with your Books) is a freemium MCP server for accounting and tax.
- [Cijferlink](https://ai-powered.com/mcp/cijferlink): Cijferlink is a freemium MCP server for accounting and tax.
- [PolyAccounts accounting](https://ai-powered.com/mcp/polyaccounts-accounting): PolyAccounts accounting is a freemium MCP server for finance and payments.
- [Kontiq](https://ai-powered.com/mcp/kontiq): Kontiq is a paid MCP server for accounting and tax.
- [Ledger Botje - Exact Online MCP](https://ai-powered.com/mcp/ledger-botje-exact-online-mcp): Ledger Botje - Exact Online MCP is a paid MCP server for accounting and tax.
- [LedgerHQ](https://ai-powered.com/mcp/ledgerhq): LedgerHQ is an MCP server for accounting and tax.

---
Source: https://ai-powered.com/mcp/fiscai-octopus-api-connector
