Skip to main content
Glama
aringad

Fatture in Cloud MCP Server

by aringad
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Fatture in Cloud MCP Server

🇮🇹 Italiano | 🇬🇧 English

Italiano

Server MCP (Model Context Protocol) per integrare Fatture in Cloud con Claude AI e altri assistenti compatibili.

Permette di gestire fatture elettroniche italiane tramite conversazione naturale.

✨ Funzionalità

Tool

Descrizione

list_invoices

Lista fatture emesse per anno/mese

get_invoice

Dettaglio completo fattura

list_clients

Lista clienti con filtro

get_company_info

Info azienda collegata

create_invoice

Crea nuova fattura (bozza)

duplicate_invoice

Duplica fattura esistente

send_to_sdi

Invia fattura allo SDI

get_invoice_status

Stato fattura elettronica

send_email

Invia copia cortesia via email

list_received_documents

Fatture passive (fornitori)

get_situation

Dashboard: fatturato, incassato, costi

🚀 Installazione

Prerequisiti

1. Clona il repository

git clone https://github.com/aringad/fattureincloud-mcp.git cd fattureincloud-mcp

2. Crea ambiente virtuale e installa dipendenze

python -m venv venv source venv/bin/activate # Linux/Mac # oppure: venv\Scripts\activate # Windows pip install -r requirements.txt

3. Configura le credenziali

Copia il file di esempio e inserisci i tuoi dati:

cp .env.example .env

Modifica .env:

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

Come ottenere le credenziali:

  1. Accedi a Fatture in Cloud

  2. Vai su Impostazioni > API e Integrazioni

  3. Crea un Token Manuale con i permessi necessari

  4. Il COMPANY_ID è visibile nell'URL quando sei loggato

4. Configura Claude Desktop

Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{ "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" } } } }

5. Riavvia Claude Desktop

Chiudi completamente Claude Desktop (Cmd+Q su Mac) e riaprilo.

💬 Esempi d'uso

"Mostrami le fatture di dicembre 2024" "Qual è la situazione finanziaria del 2025?" "Duplica la fattura 310 cambiando 2025 in 2026" "Invia la fattura 326 allo SDI" "Manda la copia cortesia via email" "Quali fatture devo ancora incassare?"

⚠️ Note di sicurezza

  • Le operazioni di scrittura (create, send_to_sdi) richiedono sempre conferma

  • L'invio allo SDI è irreversibile

  • Le fatture vengono create come bozze (draft)

  • Il metodo di pagamento di default è MP05 (bonifico)

📄 Licenza

MIT - Vedi LICENSE

👨‍💻 Autore

Sviluppato da Mediaform s.c.r.l. - Genova, Italia

English

MCP (Model Context Protocol) Server to integrate Fatture in Cloud with Claude AI and other compatible assistants.

Manage Italian electronic invoices through natural conversation.

✨ Features

Tool

Description

list_invoices

List issued invoices by year/month

get_invoice

Full invoice details

list_clients

List clients with filter

get_company_info

Connected company info

create_invoice

Create new invoice (draft)

duplicate_invoice

Duplicate existing invoice

send_to_sdi

Send invoice to SDI (Italian e-invoice system)

get_invoice_status

E-invoice status

send_email

Send courtesy copy via email

list_received_documents

Received invoices (suppliers)

get_situation

Dashboard: revenue, collected, costs

🚀 Installation

Prerequisites

1. Clone the repository

git clone https://github.com/aringad/fattureincloud-mcp.git cd fattureincloud-mcp

2. Create 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

Copy the example file and fill in your data:

cp .env.example .env

Edit .env:

FIC_ACCESS_TOKEN=a/xxxxx.yyyyy.zzzzz FIC_COMPANY_ID=123456 FIC_SENDER_EMAIL=billing@yourcompany.com

How to get credentials:

  1. Log into Fatture in Cloud

  2. Go to Settings > API and Integrations

  3. Create a Manual Token with required permissions

  4. The COMPANY_ID is visible in the URL when logged in

4. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{ "mcpServers": { "fattureincloud": { "command": "/full/path/to/fattureincloud-mcp/venv/bin/python", "args": ["/full/path/to/fattureincloud-mcp/server.py"], "env": { "FIC_ACCESS_TOKEN": "a/xxxxx.yyyyy.zzzzz", "FIC_COMPANY_ID": "123456", "FIC_SENDER_EMAIL": "billing@yourcompany.com" } } } }

5. Restart Claude Desktop

Fully quit Claude Desktop (Cmd+Q on Mac) and reopen it.

💬 Usage examples

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

⚠️ Security notes

  • Write operations (create, send_to_sdi) always require confirmation

  • Sending to SDI is irreversible

  • Invoices are created as drafts

  • Default payment method is MP05 (bank transfer)

📄 License

MIT - See LICENSE

👨‍💻 Author

Developed by Mediaform s.c.r.l. - Genova, Italy

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aringad/fattureincloud-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server