fattureincloud-mcp — Claude Code MCP server: what it does and setup
Brings Italian electronic invoicing in FattureInCloud to AI agents, handling document drafts, SDI submissions, and client records.
claude mcp add --env FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> --env FIC_COMPANY_ID=<FIC_COMPANY_ID> --env FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> --transport stdio fattureincloud-mcp -- uvx fattureincloud-mcpWhat fattureincloud-mcp does
The server exposes 23 tools for FattureInCloud operations. You can assemble draft invoices and proforma documents directly in chat. It handles conversion of proformas into final invoices, verifies numbering gaps, and submits completed documents to the Italian SDI exchange platform.
Beyond outgoing billing, it tracks supplier expenses and links entries to cost centers. Yearly summaries report collected revenue, outstanding invoices, and calculated margins. Client lists and cost center tags are kept in a local 24-hour cache to avoid redundant API lookups.
Payment registration is deliberately excluded from the tools. The underlying API requires payment account details that cannot be handled predictably, so marking items as paid stays inside the web panel. Setup requires your company ID and an API token.
What it helps with
- Draft an electronic invoice with an assigned revenue center
- Transmit finalized documents to the Italian SDI portal
- Verify continuous document numbering across issued invoices
- Register incoming supplier receipts under specified cost centers
Example prompts for the agent
- Locate Acme Srl and draft an invoice for 1500 EUR plus VAT due in 30 days
- Duplicate every invoice issued in October for Recurring Customer Co with November dates
- Fetch the financial situation summary for 2025 to see revenue and pending balances
How to install fattureincloud-mcp
Platform CLI
claude mcp add --env FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> --env FIC_COMPANY_ID=<FIC_COMPANY_ID> --env FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> --transport stdio fattureincloud-mcp -- uvx fattureincloud-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fattureincloud-mcp <command>
Platform CLI
codex mcp add fattureincloud-mcp --env FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> --env FIC_COMPANY_ID=<FIC_COMPANY_ID> --env FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> -- uvx fattureincloud-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fattureincloud-mcp <command>
Config file
{
"mcpServers": {
"fattureincloud-mcp": {
"command": "uvx",
"args": [
"fattureincloud-mcp"
],
"env": {
"FIC_ACCESS_TOKEN": "<FIC_ACCESS_TOKEN>",
"FIC_COMPANY_ID": "<FIC_COMPANY_ID>",
"FIC_SENDER_EMAIL": "<FIC_SENDER_EMAIL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fattureincloud-mcp <command>
Config file
{
"servers": {
"fattureincloud-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fattureincloud-mcp"
],
"env": {
"FIC_ACCESS_TOKEN": "<FIC_ACCESS_TOKEN>",
"FIC_COMPANY_ID": "<FIC_COMPANY_ID>",
"FIC_SENDER_EMAIL": "<FIC_SENDER_EMAIL>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fattureincloud-mcp <command>
Platform CLI
gemini mcp add -e FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> -e FIC_COMPANY_ID=<FIC_COMPANY_ID> -e FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> fattureincloud-mcp uvx fattureincloud-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fattureincloud-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about fattureincloud-mcp
How to install fattureincloud-mcp in Claude Code?
Run this terminal command: claude mcp add fattureincloud-mcp -e FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> -e FIC_COMPANY_ID=<FIC_COMPANY_ID> -- uvx fattureincloud-mcp.
What does fattureincloud-mcp do?
It connects your assistant to FattureInCloud to manage Italian electronic invoices, customer profiles, and supplier expenses.
Can this MCP server mark invoices as paid?
No. The API needs specific payment account parameters that the SDK cannot resolve reliably, so payment status updates must be made in the FattureInCloud web panel.
