Fatture in Cloud

MCP server that manages Italian electronic invoices via natural language with Claude AI and compatible assistants.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aringad-fattureincloud-mcp": {
      "command": "/percorso/completo/fattureincloud-mcp/venv/bin/python",
      "args": [
        "/percorso/completo/fattureincloud-mcp/server.py"
      ],
      "env": {
        "FIC_COMPANY_ID": "123456",
        "FIC_ACCESS_TOKEN": "a/xxxxx.yyyyy.zzzzz",
        "FIC_SENDER_EMAIL": "fatturazione@tuaazienda.it"
      }
    }
  }
}

You can connect Fatture in Cloud to Claude AI and compatible assistants through an MCP (Model Context Protocol) server. This integration lets you manage Italian electronic invoices through natural language, unlocking conversational workflows for common invoice tasks while keeping data flow under your control.

How to use

You will interact with the MCP server via your MCP client. Use natural language prompts to list invoices, view details, create drafts, duplicate invoices, send to SDI, and check the financial dashboard. Typical tasks include asking for invoices in a given month, reviewing an invoice, duplicating a past entry with changes, or sending a document to SDI. You can also retrieve company information, filter clients, and manage received documents from suppliers.

How to install

Prerequisites and initial setup ensure the MCP server can run locally and securely connect to Fatture in Cloud.

# 1. Clone the MCP server code
git clone https://github.com/aringad/fattureincloud-mcp.git
cd fattureincloud-mcp

# 2. Create a virtual environment and install dependencies
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or: venv\Scripts\activate  # Windows

pip install -r requirements.txt

Configure credentials by copying the example and filling in your own data.

cp .env.example .env

Edit .env to include your credentials:

FIC_ACCESS_TOKEN=a/xxxxx.yyyyy.zzzzz
FIC_COMPANY_ID=123456
FIC_SENDER_EMAIL=fatturazione@tuaazienda.it

How to obtain credentials:

Log into Fatture in Cloud
Go to Settings > API and Integrazioni
Create a Manual Token with required permissions
The COMPANY_ID is visible in the URL when you are logged in


4. Configure Claude Desktop to run the MCP server using the Python virtual environment.

{ "mcpServers": { "fattureincloud": { "command": "/percorso/completo/fattureincloud-mcp/venv/bin/python", "args": ["/percorso/completo/fattureincloud-mcp/server.py"], "env": { "FIC_ACCESS_TOKEN": "a/xxxxx.yyyyy.zzzzz", "FIC_COMPANY_ID": "123456", "FIC_SENDER_EMAIL": "fatturazione@tuaazienda.it" } } } }

## Additional setup notes

After configuring, fully quit Claude Desktop and reopen it to apply the MCP configuration.

## Examples of usage

"Show me invoices from December 2024" "What is the financial status for 2025?" "Duplicate invoice 310 changing 2025 to 2026" "Send invoice 326 to SDI" "Send the courtesy copy via email" "Which invoices are still awaiting payment?"

## Security notes

Writing operations (create, send\_to\_sdi) always require explicit confirmation. Sending to SDI is irreversible. Invoices are created as drafts and the default payment method is MP05 (bank transfer).

## Available tools

### list\_invoices

List issued invoices by year and month

### get\_invoice

Retrieve full details for a specific invoice

### list\_clients

List clients with optional filters

### get\_company\_info

Fetch connected company information

### create\_invoice

Create a new invoice as a draft

### duplicate\_invoice

Duplicate an existing invoice

### send\_to\_sdi

Submit an invoice to the SDI (Italian e-invoice system)

### get\_invoice\_status

Check the status of an e-invoice

### send\_email

Send a courtesy copy of an invoice via email

### list\_received\_documents

List received documents from suppliers

### get\_situation

Dashboard data: revenue, collected, costs

Built by

VeilStrat

AI signals for GTM teams