# fattureincloud-mcp

Brings Italian electronic invoicing in FattureInCloud to AI agents, handling document drafts, SDI submissions, and client records.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 25
- Author: aringad
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aringad/fattureincloud-mcp
- Updated: 2026-09-01
- HTML: https://affpapa.org/en/nevibecode/mcp/fattureincloud-mcp

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `FIC_ACCESS_TOKEN`, `FIC_COMPANY_ID`, `FIC_SENDER_EMAIL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
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>

### Codex

**Platform CLI**
```bash
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-mcp
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
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>

## When to use it
- 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
- 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

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md