Siigo

Unofficial MCP server for Siigo invoicing software exposing read and write operations to Siigo API endpoints safely

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "dsfaccini-siigo-mcp": {
      "command": "uvx",
      "args": [
        "siigo-mcp"
      ],
      "env": {
        "DRY_RUN": "true",
        "SIIGO_MODE": "read_only",
        "LOGFIRE_TOKEN": "<LOGFIRE_TOKEN>",
        "SIIGO_USERNAME": "your-email@example.com",
        "SIIGO_ACCESS_KEY": "your-access-key",
        "SIIGO_LAZY_TOOLS": "true",
        "SIIGO_PARTNER_ID": "your-partner-id"
      }
    }
  }
}

You deploy and run an MCP server that exposes Siigo invoicing API endpoints to your client applications. It runs locally as a small, self-contained service you can connect to with MCP clients, enabling read-only by default and optional write operations when you enable broader tool modes. This setup helps you safely explore data from Siigo while providing a clear path to production use if needed.

How to use

Connect your MCP client to the Siigo MCP server using the stdio configuration. Start the server with the standard runtime command and environment variables, then use your MCP client to discover and invoke available tools. Begin with read-only operations to list and fetch data, then enable broader tool modes only if you understand the implications and security considerations.

How to install

Prerequisites you need before installing the Siigo MCP server:

A compatible environment with Node-like tooling or the UV runtime
Internet access to fetch dependencies

Option 1: Use UVX (recommended, no install)

Available tools

get_taxes

Retrieve tax configurations that define how taxes are applied within Siigo.

get_payment_types

List the available payment methods supported by Siigo.

get_document_types

Fetch document types (e.g., FV, NC) used for invoicing.

get_warehouses

Obtain warehouse locations for inventory management.

get_users

List system users defined in the Siigo account.

get_account_groups

Retrieve account classifications used in accounting.

list_customers

List customers with optional pagination and filters.

get_customer

Get a customer by their ID.

list_products

List products with optional pagination and filters.

get_product

Get a product by its ID.

list_invoices

List invoices with optional pagination and filters.

get_invoice

Get an invoice by its ID.

get_invoice_pdf

Download the PDF version of an invoice.

get_stamp_errors

Retrieve DIAN stamping errors for invoices.

list_credit_notes

List credit notes with optional pagination and filters.

get_credit_note

Get a credit note by its ID.

get_credit_note_pdf

Download the PDF for a credit note.

list_journals

List journal entries with pagination/filters.

get_journal

Get a journal entry by ID.

create_customer

Create a new customer.

update_customer

Update an existing customer.

delete_customer

Delete a customer.

create_product

Create a new product.

update_product

Update an existing product.

delete_product

Delete a product.

create_invoice

Create a new invoice.

update_invoice

Update an existing invoice.

delete_invoice

Delete an invoice.

create_credit_note

Create a new credit note.

create_journal

Create a new journal entry.

stamp_invoice

Send an invoice to DIAN for electronic stamping (full mode only).

annul_invoice

Annul or cancel an official invoice (full mode only).

send_invoice_email

Email an invoice to a customer (full mode only).

Built by

VeilStrat

AI signals for GTM teams