home / mcp / fatture in cloud mcp server

Fatture in Cloud MCP Server

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

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "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": "[email protected]"
      }
    }
  }
}

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

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

cp .env.example .env
```

Edit `.env` to include your credentials:
```env
FIC_ACCESS_TOKEN=a/xxxxx.yyyyy.zzzzz
FIC_COMPANY_ID=123456
[email protected]
```

How to obtain credentials:
1. Log into Fatture in Cloud
2. Go to Settings > API and Integrazioni
3. Create a Manual Token with required permissions
4. 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": "[email protected]"
      }
    }
  }
}

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