Skip to content
MCP server

MCP Facturapi

MCP server giving AI clients access to FacturAPI for Mexican CFDI e-invoicing

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.2.2
Listing updated
today

Similar MCP servers

About MCP Facturapi

MCP Facturapi is an open-source MCP server for accounting and tax. It runs locally on your machine and is started by your AI client.

The README describes this server as a bridge between AI clients and FacturAPI, a Mexican platform for issuing CFDI electronic invoices, which it compares to Brazil's NFe system. Once connected, a client can create, fetch, list and cancel invoices, pull PDF and XML download links, and email invoices to customers.

Beyond invoices, the server exposes tools for managing customers and products used in invoicing, plus receipts (recibo de venta) that a customer can later convert into an invoice using the receipt's folio. A list-webhooks tool is also included. The server runs over stdio via an npm package, and the README also mentions an HTTP mode toggled by an environment variable.

The README points mainly at developers and finance teams in Mexico who want an agent to handle invoicing tasks. It requires a FacturAPI API key, which is read from an environment variable and stored as a secret.

Install

Run in a terminal

claude mcp add mcp-facturapi --env FACTURAPI_API_KEY='<FACTURAPI_API_KEY>' -- npx -y @codespar/mcp-facturapi

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-facturapi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-facturapi"
      ],
      "env": {
        "FACTURAPI_API_KEY": "<FACTURAPI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-facturapi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-facturapi"
      ],
      "env": {
        "FACTURAPI_API_KEY": "<FACTURAPI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-facturapi": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-facturapi"
      ],
      "env": {
        "FACTURAPI_API_KEY": "<FACTURAPI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-facturapi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-facturapi"
      ],
      "env": {
        "FACTURAPI_API_KEY": "<FACTURAPI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-facturapi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-facturapi"
      ],
      "env": {
        "FACTURAPI_API_KEY": "<FACTURAPI_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • FACTURAPI_API_KEYAPI key for FacturAPIRequired

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

create_invoice
Create a CFDI invoice
get_invoice
Get invoice by ID
list_invoices
List invoices with filters
cancel_invoice
Cancel an invoice
download_invoice_pdf
Download invoice as PDF (returns download URL)
download_invoice_xml
Download invoice as XML (returns download URL)
send_invoice_email
Send invoice (PDF + XML) by email to the customer or to specific recipients
create_customer
Create a customer for invoicing
get_customer
Get customer by ID
list_customers
List customers with optional filters
update_customer
Update an existing customer (partial update)
delete_customer
Delete a customer
create_product
Create a product for invoicing
get_product
Get product by ID
list_products
List products
update_product
Update an existing product (partial update)
delete_product
Delete a product
create_receipt
Create a receipt (recibo de venta)
list_receipts
List receipts with filters
list_webhooks
List configured webhooks

What it does

Invoice lifecycle tools
Create, retrieve, list and cancel CFDI invoices through dedicated MCP tools.
PDF and XML downloads
Returns download URLs for invoice PDF and XML files.
Email delivery
Sends invoices with PDF and XML attachments to the customer or chosen recipients.
Customer and product records
Create, read, update and delete customers and products used for invoicing.
Receipt to invoice flow
Creates sales receipts that customers can later self-invoice using the folio.
Stdio and HTTP transport
Runs over stdio by default, with an optional HTTP mode set by environment variable.

Good for

  • Letting an AI assistant issue CFDI invoices after a sale is recorded
  • Looking up or cancelling past invoices from a chat interface
  • Emailing invoice PDFs and XML files to customers automatically
  • Keeping customer and product catalogs in sync for invoicing
  • Generating sales receipts that customers can convert into invoices themselves

Pricing

Open source

MIT-licensed MCP server; FacturAPI account required for API access.

MCP Facturapi FAQ

What credential does the server need?

It requires a FacturAPI API key, provided through the FACTURAPI_API_KEY environment variable and marked as secret.

Which transports are supported?

The registry entry lists stdio. The README also describes an optional HTTP mode enabled with MCP_HTTP and configured with MCP_PORT.

What license does it use?

The README states the MIT license.

How many tools does it expose?

The README lists 20 tools covering invoices, customers, products, receipts and webhooks.

Is MCP Facturapi free?

Yes. MCP Facturapi is open source, so you can use and self-host it for free.

How do I add MCP Facturapi to Claude Code?

Run this command in your terminal: claude mcp add mcp-facturapi --env FACTURAPI_API_KEY='<FACTURAPI_API_KEY>' -- npx -y @codespar/mcp-facturapi

What are the best alternatives to MCP Facturapi?

The closest alternatives to MCP Facturapi are Facture App MCP by usefulapi, Facturis Online MCP by usefulapi, Cuéntica MCP by usefulapi, Fiscalo MCP by usefulapi and WeFact MCP by usefulapi.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers