Back to Browse
Free
Server data from the Official MCP Registry
Italian e-invoicing with Fatture in Cloud. Create, send to SDI, manage clients.
About
Italian e-invoicing with Fatture in Cloud. Create, send to SDI, manage clients.
Security Report
7.0
Moderate7.0Low RiskValid MCP server (3 strong, 1 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
What You'll Need
Set these up before or after installing:
Fatture in Cloud API access tokenRequired
Environment variable: FIC_ACCESS_TOKEN
Fatture in Cloud company ID
Environment variable: FIC_COMPANY_ID
Email sender for courtesy copies
Environment variable: FIC_SENDER_EMAIL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-aringad-fattureincloud-mcp": {
"env": {
"FIC_COMPANY_ID": "your-fic-company-id-here",
"FIC_ACCESS_TOKEN": "your-fic-access-token-here",
"FIC_SENDER_EMAIL": "your-fic-sender-email-here"
},
"args": [
"fattureincloud-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Fatture in Cloud MCP Server
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à (20 tool)
| Tool | Descrizione |
|---|---|
list_invoices | Lista fatture/NDC/proforma emesse per anno/mese |
get_invoice | Dettaglio completo documento |
get_pdf_url | URL PDF e link web documento |
list_clients | Lista clienti con filtro |
get_company_info | Info azienda collegata |
create_client | 🆕 Crea nuovo cliente in anagrafica |
update_client | 🆕 Aggiorna dati cliente esistente |
create_invoice | Crea nuova fattura (bozza) con codice SDI automatico |
create_credit_note | Crea nota di credito (bozza) |
create_proforma | Crea proforma (bozza, non inviabile SDI) |
convert_proforma_to_invoice | 🆕 Converte proforma in fattura elettronica |
update_document | Modifica parziale documento bozza |
duplicate_invoice | Duplica fattura con codice SDI aggiornato |
delete_invoice | Elimina documento bozza (non inviato) |
send_to_sdi | Invia fattura allo SDI |
get_invoice_status | Stato fattura elettronica SDI |
send_email | Invia copia cortesia via email |
list_received_documents | Fatture passive (fornitori) |
get_situation | Dashboard: fatturato netto, incassato, costi, margine |
check_numeration | Verifica continuità numerica fatture |
Nota: La marcatura dei pagamenti come "pagato" non è supportata. Usa il pannello web di Fatture in Cloud per questa operazione.
🚀 Installazione
Prerequisiti
- Python 3.10+
- Account Fatture in Cloud con API attive
- Claude Desktop o altro client MCP
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:
- Accedi a Fatture in Cloud
- Vai su Impostazioni > API e Integrazioni
- Crea un Token Manuale con i permessi necessari
- 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?"
"Verifica la numerazione delle fatture 2025"
"Converti la proforma 12 in fattura"
"Crea un nuovo cliente: Rossi SRL, P.IVA 01234567890"
⚠️ 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 codice univoco SDI viene recuperato automaticamente dall'anagrafica cliente
- Il metodo di pagamento di default è MP05 (bonifico)
📋 Changelog
Vedi CHANGELOG.md
📄 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 (20 tools)
| Tool | Description |
|---|---|
list_invoices | List invoices/credit notes/proforma by year/month |
get_invoice | Full document details |
get_pdf_url | PDF URL and web link for document |
list_clients | List clients with filter |
get_company_info | Connected company info |
create_client | 🆕 Create new client in registry |
update_client | 🆕 Update existing client data |
create_invoice | Create new invoice (draft) with automatic SDI code |
create_credit_note | Create credit note (draft) |
create_proforma | Create proforma (draft, not sendable to SDI) |
convert_proforma_to_invoice | 🆕 Convert proforma to electronic invoice |
update_document | Partial update of draft document |
duplicate_invoice | Duplicate invoice with updated SDI code |
delete_invoice | Delete draft document (not yet sent) |
send_to_sdi | Send invoice to SDI (Italian e-invoice system) |
get_invoice_status | E-invoice SDI status |
send_email | Send courtesy copy via email |
list_received_documents | Received invoices (suppliers) |
get_situation | Dashboard: net revenue, collected, costs, margin |
check_numeration | Verify invoice numbering continuity |
Note: Marking payments as "paid" is not supported. Use the Fatture in Cloud web panel for this operation.
🚀 Installation
Prerequisites
- Python 3.10+
- Fatture in Cloud account with API enabled
- Claude Desktop or other MCP client
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:
- Log into Fatture in Cloud
- Go to Settings > API and Integrations
- Create a Manual Token with required permissions
- The
COMPANY_IDis 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?"
"Check invoice numbering for 2025"
"Convert proforma 12 to invoice"
"Create a new client: Rossi SRL, VAT 01234567890"
⚠️ Security notes
- Write operations (create, send_to_sdi) always require confirmation
- Sending to SDI is irreversible
- Invoices are created as drafts
- SDI unique code is automatically retrieved from client registry
- Default payment method is MP05 (bank transfer)
📋 Changelog
See CHANGELOG.md
📄 License
MIT - See LICENSE
👨💻 Author
Developed by Mediaform s.c.r.l. - Genova, Italy
Reviews
No reviews yet
Be the first to review this server!
More Business Tools MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
404
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
89.9K
Stars
15
Installs
6.0
Security
5.0
Local