How do I use Siigo MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Siigo MCP Server list all products with stock less than 10" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Siigo MCP Server

by crisgon0295

Overview Schema Source Related Servers Discussions Admin

Remote

Siigo MCP Server

A Model Context Protocol (MCP) server that provides full integration with the Siigo API, enabling access to Colombian accounting software features including products, customers, invoices, quotations, purchases, credit notes, vouchers, payment receipts, journals, webhooks, and more.

v3.2.0 - Split tool modules for maintainability, 75 tools, purchase support documents, updated cash receipt support, MCP SDK v1.29, Zod schemas, improved MCP error propagation, and complete TypeScript type safety.

Features

This MCP server provides access to all Siigo API endpoints:

Core Resources

Products: Full CRUD for products, services, consumer goods, and Combo products with components
Customers: Manage customers, suppliers, and third parties
Invoices: Sales invoices with electronic invoicing, healthcare sector, batch creation, annulment, PDF, XML, and DIAN error queries
Quotations: Full CRUD for quotations (cotizaciones) -- NEW in v3
Purchase Support Documents: Full CRUD for documentos soporte (/purchase-support-documents)
Purchases: Purchase invoices and expenses
Credit Notes: Create and query credit notes with PDF support and healthcare sector fields
Vouchers: Cash receipts (recibos de caja), including debt payments, advance payments, and miscellaneous income
Payment Receipts: Payment receipts / disbursements (recibos de pago / comprobantes de egreso) - full CRUD
Journals: Accounting journal entries (comprobantes contables)
Webhooks: Subscribe to and manage webhook events -- NEW in v3

Inventory Management

Account Groups: Create and edit inventory categories -- NEW in v3

Catalogs

Document types (FV, RC, NC, FC, CC, RP, C, DS)
Taxes, payment types, cost centers
Users/sellers, warehouses, price lists
Account groups, cities, ID types
Fiscal responsibilities, fixed assets, expenses, miscellaneous income concepts

Reports

Trial balance reports (general and by third party)
Accounts payable reports

Related MCP server: Siigo MCP Server

Installation

Option 1: NPX (Recommended - No Installation Required)

npx @jdlar/siigo-mcp

Option 2: Global Installation

npm install -g @jdlar/siigo-mcp
siigo-mcp

Option 3: Local Development / Building from Source

git clone https://github.com/jdlar1/siigo-mcp.git
cd siigo-mcp
npm install
npm run build
cp .env.example .env
# Edit .env with your Siigo credentials

Configuration

Required Environment Variables

Variable	Description
`SIIGO_USERNAME`	Your Siigo API username
`SIIGO_ACCESS_KEY`	Your Siigo API access key
`SIIGO_PARTNER_ID`	Partner ID for API identification (3-100 alphanumeric chars, no spaces)

Optional Environment Variables

Variable	Default	Description
`SIIGO_BASE_URL`	`https://api.siigo.com`	API base URL

Getting Siigo API Credentials

Sign up for a Siigo account at siigo.com
Access the API section in your Siigo dashboard
Generate your API credentials (username and access key)
For testing, use the sandbox environment

MCP Client Configuration

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "siigo": {
      "command": "npx",
      "args": ["@jdlar/siigo-mcp"],
      "env": {
        "SIIGO_USERNAME": "your_username",
        "SIIGO_ACCESS_KEY": "your_access_key",
        "SIIGO_PARTNER_ID": "your_app_name"
      }
    }
  }
}

Available Tools (68 total)

Products (6 tools)

Tool	Description	Annotations
`siigo_get_products`	List products with pagination	read-only
`siigo_get_product`	Get a product by ID	read-only
`siigo_create_product`	Create product (supports Combo type with components)
`siigo_update_product`	Update a product
`siigo_delete_product`	Delete a product	destructive
`siigo_search_products`	Search by code, name, or reference (partial match)	read-only

Account Groups / Inventory Categories (3 tools)

Tool	Description	Annotations
`siigo_get_account_groups`	List inventory categories	read-only
`siigo_create_account_group`	Create inventory category
`siigo_update_account_group`	Update inventory category

Customers (5 tools)

Tool	Description	Annotations
`siigo_get_customers`	List customers	read-only
`siigo_get_customer`	Get a customer by ID	read-only
`siigo_create_customer`	Create a customer/third party
`siigo_update_customer`	Update a customer
`siigo_search_customers`	Search by identification, name, or type	read-only

Invoices (10 tools)

Tool	Description	Annotations
`siigo_get_invoices`	List invoices with date filters	read-only
`siigo_get_invoice`	Get an invoice by ID	read-only
`siigo_create_invoice`	Create invoice (supports healthcare and transport sectors)
`siigo_update_invoice`	Update an invoice
`siigo_delete_invoice`	Delete an invoice	destructive
`siigo_annul_invoice`	Annul (void) an invoice	destructive
`siigo_get_invoice_pdf`	Get invoice PDF (base64)	read-only
`siigo_get_invoice_xml`	Get invoice electronic XML (base64)	read-only
`siigo_get_invoice_stamp_errors`	Get DIAN rejection errors	read-only
`siigo_send_invoice_email`	Send invoice by email (up to 5 addresses)

Batch Invoices (1 tool)

Tool	Description	Annotations
`siigo_create_invoice_batch`	Create invoices in batch (async with webhook notification)

Quotations (5 tools)

Tool	Description	Annotations
`siigo_get_quotations`	List quotations with date filters	read-only
`siigo_get_quotation`	Get a quotation by ID	read-only
`siigo_create_quotation`	Create a quotation (document type C)
`siigo_update_quotation`	Update a quotation
`siigo_delete_quotation`	Delete a quotation	destructive

Credit Notes (4 tools)

Tool	Description	Annotations
`siigo_get_credit_notes`	List credit notes	read-only
`siigo_get_credit_note`	Get a credit note by ID	read-only
`siigo_create_credit_note`	Create credit note (supports healthcare sector, external invoice refs)
`siigo_get_credit_note_pdf`	Get credit note PDF (base64)	read-only

Vouchers / Cash Receipts (3 tools)

Tool	Description	Annotations
`siigo_get_vouchers`	List cash receipts (recibos de caja)	read-only
`siigo_get_voucher`	Get a cash receipt by ID	read-only
`siigo_create_voucher`	Create cash receipt (DebtPayment, AdvancePayment, MiscIncome)

Purchase Support Documents (5 tools)

Tool	Description	Annotations
`siigo_get_purchase_support_documents`	List purchase support documents	read-only
`siigo_get_purchase_support_document`	Get a purchase support document by ID	read-only
`siigo_create_purchase_support_document`	Create purchase support document (document type DS)
`siigo_update_purchase_support_document`	Update a purchase support document
`siigo_delete_purchase_support_document`	Delete a purchase support document	destructive

Purchases (5 tools)

Tool	Description	Annotations
`siigo_get_purchases`	List purchase invoices	read-only
`siigo_get_purchase`	Get a purchase by ID	read-only
`siigo_create_purchase`	Create purchase (use FC type with `document_support` for Documento Soporte)
`siigo_update_purchase`	Update a purchase
`siigo_delete_purchase`	Delete a purchase	destructive

Payment Receipts / Disbursements (5 tools)

Tool	Description	Annotations
`siigo_get_payment_receipts`	List payment receipts (recibos de pago / comprobantes de egreso)	read-only
`siigo_get_payment_receipt`	Get a payment receipt by ID	read-only
`siigo_create_payment_receipt`	Create payment receipt (DebtPayment, AdvancePayment, Advanced)
`siigo_update_payment_receipt`	Update a payment receipt
`siigo_delete_payment_receipt`	Delete a payment receipt	destructive

Journals / Accounting Entries (3 tools)

Tool	Description	Annotations
`siigo_get_journals`	List accounting journals (comprobantes contables)	read-only
`siigo_get_journal`	Get a journal by ID	read-only
`siigo_create_journal`	Create journal entry (debits must equal credits)

Webhooks (4 tools)

Tool	Description	Annotations
`siigo_get_webhooks`	List webhook subscriptions	read-only
`siigo_create_webhook`	Subscribe to a webhook event
`siigo_update_webhook`	Update a webhook subscription
`siigo_delete_webhook`	Delete a webhook subscription	destructive

Catalogs (13 tools + account groups above)

Tool	Description
`siigo_get_document_types`	Document types (FV, RC, NC, FC, CC, RP, C, DS)
`siigo_get_taxes`	Taxes (IVA, Retefuente, ReteIVA, ReteICA, etc.)
`siigo_get_payment_types`	Payment methods
`siigo_get_cost_centers`	Cost centers
`siigo_get_users`	Users/sellers
`siigo_get_warehouses`	Warehouses
`siigo_get_price_lists`	Price lists (up to 12)
`siigo_get_cities`	Colombian cities
`siigo_get_expenses`	Expenses for cash receipt adjustments
`siigo_get_misc_income`	Miscellaneous income concepts for cash receipts
`siigo_get_id_types`	Identification types
`siigo_get_fiscal_responsibilities`	Fiscal responsibilities
`siigo_get_fixed_assets`	Fixed assets

Reports (3 tools)

Tool	Description
`siigo_get_trial_balance`	Trial balance report (Excel)
`siigo_get_trial_balance_by_third`	Trial balance by third party (Excel)
`siigo_get_accounts_payable`	Accounts payable report

Document Types Reference

Code	Spanish Name	English Name	MCP Support
`FV`	Factura de Venta	Sales Invoice	Full CRUD + PDF/XML/Email/Batch/Annul
`RC`	Recibo de Caja	Cash Receipt	Create + Query
`NC`	Nota Credito	Credit Note	Create + Query + PDF
`FC`	Factura de Compra	Purchase Invoice	Full CRUD
`CC`	Comprobante Contable	Accounting Journal	Create + Query
`RP`	Recibo de Pago/Egreso	Payment Receipt	Full CRUD
`C`	Cotizacion	Quotation	Full CRUD

Example Usage

Create a Quotation

{
  "name": "siigo_create_quotation",
  "arguments": {
    "quotation": {
      "document": { "id": 12345 },
      "date": "2026-02-13",
      "customer": { "identification": "13832081", "branch_office": 0 },
      "seller": 629,
      "items": [{
        "code": "PROD001",
        "quantity": 5,
        "price": 50000,
        "taxes": [{ "id": 13156 }]
      }]
    }
  }
}

Create a Combo Product

{
  "name": "siigo_create_product",
  "arguments": {
    "product": {
      "code": "COMBO-001",
      "name": "Kit de oficina",
      "account_group": 1253,
      "type": "Combo",
      "components": [
        { "code": "PROD-001", "quantity": 2 },
        { "code": "PROD-002", "quantity": 1 }
      ]
    }
  }
}

Create a Healthcare Invoice

{
  "name": "siigo_create_invoice",
  "arguments": {
    "invoice": {
      "document": { "id": 24446 },
      "date": "2026-02-13",
      "customer": { "identification": "13832081" },
      "seller": 629,
      "items": [{ "code": "SRV001", "quantity": 1, "price": 150000 }],
      "payments": [{ "id": 5636, "value": 150000 }],
      "healthcare_company": {
        "operation_type": "SS-CUFE",
        "period_start": "2026-01-01",
        "period_end": "2026-01-31"
      }
    }
  }
}

Create Batch Invoices

{
  "name": "siigo_create_invoice_batch",
  "arguments": {
    "notification_url": "https://myapp.com/webhooks/siigo-batch",
    "invoices": [
      {
        "idempotency_key": "INV202602001",
        "document": { "id": 24446 },
        "date": "2026-02-13",
        "customer": { "identification": "13832081" },
        "seller": 629,
        "items": [{ "code": "PROD001", "quantity": 1, "price": 50000 }],
        "payments": [{ "id": 5636, "value": 50000 }]
      }
    ]
  }
}

API Rate Limits

Production: 100 requests per minute per company
Sandbox: 10 requests per minute

The server uses a 120-second HTTP timeout as recommended by Siigo for long-running operations.

Error Handling

The server handles Siigo API errors and returns structured error responses with error codes, messages, and details. See the Siigo API docs for a full list of error codes.

Development

Project Structure

siigo-mcp/
├── src/
│   ├── index.ts          # MCP server - tool registration with Zod schemas
│   ├── siigo-client.ts   # HTTP client for all Siigo API endpoints
│   └── types.ts          # Full TypeScript interfaces for all document types
├── dist/                 # Compiled output (ESM)
├── package.json
├── tsconfig.json
├── CHANGELOG.md
└── README.md

Building

npm run build

Running for Development

npm run dev

Contributing

Fork the repository
Create a feature branch
Make your changes
Run npm run build to verify
Submit a pull request

License

MIT License

Support

Siigo API: Contact soporteapi@siigo.com
This MCP server: Create an issue

Available Tools

44 tools

siigo_get_account_groupsGet Account GroupsA

Read-only

Get inventory classification groups (account groups) catalog

Inputs: no named parameters.

siigo_get_accounts_payableGet Accounts PayableC

Read-only

Get accounts payable report

Inputs: page, page_size.

siigo_get_citiesGet CitiesA

Read-only

Get cities catalog (Colombian cities with country/state/city codes)

Inputs: no named parameters.

siigo_get_cost_centersGet Cost CentersB

Read-only

Get cost centers catalog

Inputs: no named parameters.

siigo_get_credit_noteGet Credit NoteB

Read-only

Get a specific credit note by ID

Inputs: id (required).

siigo_get_credit_note_pdfGet Credit Note PDFB

Read-only

Get credit note PDF as base64

Inputs: id (required).

siigo_get_credit_notesGet Credit NotesB

Read-only

Get list of credit notes from Siigo

Inputs: page, page_size.

siigo_get_customerGet CustomerA

Read-only

Get a specific customer by ID

Inputs: id (required).

siigo_get_customersGet CustomersB

Read-only

Get list of customers from Siigo

Inputs: page, type, page_size.

siigo_get_document_typesGet Document TypesA

Read-only

Get document types catalog. Filter by type: FV (sales invoice), RC (cash receipt), NC (credit note), FC (purchase invoice), CC (journal), RP (payment receipt), C (quotation), DS (purchase support document).

Inputs: type.

siigo_get_expensesGet ExpensesA

Read-only

Get expenses catalog used by cash receipt debt payment adjustments

Inputs: no named parameters.

siigo_get_fiscal_responsibilitiesGet Fiscal ResponsibilitiesB

Read-only

Get fiscal responsibilities catalog

Inputs: no named parameters.

siigo_get_fixed_assetsGet Fixed AssetsB

Read-only

Get fixed assets catalog

Inputs: no named parameters.

siigo_get_id_typesGet ID TypesB

Read-only

Get identification types catalog

Inputs: no named parameters.

siigo_get_invoiceGet InvoiceA

Read-only

Get a specific invoice by ID

Inputs: id (required).

siigo_get_invoice_pdfGet Invoice PDFA

Read-only

Get invoice PDF as base64

Inputs: id (required).

siigo_get_invoicesGet InvoicesC

Read-only

Get list of invoices from Siigo

Inputs: page, page_size, created_end, created_start.

siigo_get_invoice_stamp_errorsGet Invoice DIAN ErrorsA

Read-only

Get DIAN rejection errors for an invoice that failed electronic stamping

Inputs: id (required).

siigo_get_invoice_xmlGet Invoice XMLA

Read-only

Get invoice electronic XML as base64

Inputs: id (required).

siigo_get_journalGet JournalA

Read-only

Get a specific accounting journal by ID

Inputs: id (required).

siigo_get_journalsGet JournalsB

Read-only

Get list of accounting journals (comprobantes contables) from Siigo

Inputs: page, page_size.

siigo_get_misc_incomeGet Misc IncomeA

Read-only

Get miscellaneous income concepts used by MiscIncome cash receipts

Inputs: no named parameters.

siigo_get_payment_receiptGet Payment ReceiptA

Read-only

Get a specific payment receipt by ID

Inputs: id (required).

siigo_get_payment_receiptsGet Payment ReceiptsB

Read-only

Get list of payment receipts / disbursements (recibos de pago / comprobantes de egreso) from Siigo

Inputs: page, page_size.

siigo_get_payment_typesGet Payment TypesA

Read-only

Get payment types catalog. Filter by document_type to get applicable payment methods.

Inputs: document_type.

siigo_get_price_listsGet Price ListsB

Read-only

Get price lists catalog (up to 12 price lists)

Inputs: no named parameters.

siigo_get_productGet ProductA

Read-only

Get a specific product by ID

Inputs: id (required).

siigo_get_productsGet ProductsC

Read-only

Get list of products from Siigo

Inputs: page, page_size.

siigo_get_purchaseGet PurchaseA

Read-only

Get a specific purchase invoice by ID

Inputs: id (required).

siigo_get_purchasesGet PurchasesB

Read-only

Get list of purchase invoices (facturas de compra) from Siigo

Inputs: page, page_size.

siigo_get_purchase_support_documentGet Purchase Support DocumentA

Read-only

Get a specific purchase support document by ID

Inputs: id (required).

siigo_get_purchase_support_documentsGet Purchase Support DocumentsB

Read-only

Get list of purchase support documents (documentos soporte) from Siigo

Inputs: page, page_size.

siigo_get_quotationGet QuotationA

Read-only

Get a specific quotation by ID

Inputs: id (required).

siigo_get_quotationsGet QuotationsB

Read-only

Get list of quotations (cotizaciones) from Siigo

Inputs: page, page_size, created_end, created_start.

siigo_get_taxesGet TaxesA

Read-only

Get taxes catalog (IVA, Retefuente, ReteIVA, ReteICA, Impoconsumo, AdValorem, Autorretencion)

Inputs: no named parameters.

siigo_get_trial_balanceGet Trial BalanceB

Read-only

Generate trial balance report (Excel). Uses POST as per Siigo API spec.

Inputs: year (required), month_end (required), month_start (required), includes_tax_difference (required), +2 more.

siigo_get_trial_balance_by_thirdGet Trial Balance by ThirdB

Read-only

Generate trial balance by third party report (Excel). Uses POST as per Siigo API spec.

Inputs: year (required), month_end (required), month_start (required), includes_tax_difference (required), +3 more.

siigo_get_usersGet UsersB

Read-only

Get users/sellers catalog

Inputs: no named parameters.

siigo_get_voucherGet VoucherA

Read-only

Get a specific voucher / cash receipt by ID

Inputs: id (required).

siigo_get_vouchersGet VouchersA

Read-only

Get list of vouchers / cash receipts (recibos de caja) from Siigo

Inputs: page, page_size.

siigo_get_warehousesGet WarehousesC

Read-only

Get warehouses catalog

Inputs: no named parameters.

siigo_get_webhooksGet WebhooksA

Read-only

Get list of webhook subscriptions

Inputs: no named parameters.

siigo_search_customersSearch CustomersA

Read-only

Search for customers by identification, name, or type with client-side filtering for partial matches

Inputs: name, page, type, page_size, +1 more.

siigo_search_productsSearch ProductsB

Read-only

Search for products by code, name, or reference with client-side filtering for partial matches

Inputs: code, name, page, page_size, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored 2026-07-10 17:50 across 44 tools

Disambiguation5/5

Each tool targets a distinct entity or operation (e.g., get vs search, singular vs plural for lists). No two tools have overlapping purposes, so an agent can easily select the correct one.

Naming Consistency5/5

All tools follow a consistent pattern: siigo_get_<entity> or siigo_search_<entity>, all in lowercase snake_case. The verb-noun structure is uniform, aiding predictability.

Tool Count3/5

44 tools is a large number, exceeding the typical well-scoped range. While the variety of entities justifies some breadth, the sheer count can be overwhelming for an agent, especially since all tools are read-only.

Completeness4/5

The tool set covers a wide array of read operations across many Siigo entities (invoices, credit notes, journals, customers, etc.), leaving few gaps for a read-only server. However, the absence of any write operations (create, update, delete) may limit the server's usefulness if mutations are expected.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Apideck MCPA
dev.apideck.mcp
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Developer Tools
42
https://mcp.apideck.dev/mcp
Mercado Pago
com.mercadopago.mcp
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Finance E-commerce & Retail App Automation
2
https://mcp.mercadopago.com/mcp
Codat MCP by usefulapiA
io.usefulapi
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Finance ERP Systems Data Platforms
2
https://codat.usefulapi.io/mcp
Quaderno MCP by usefulapiA
io.usefulapi
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
Finance Payments & Billing
2
https://quaderno.usefulapi.io/mcp

Related MCP Servers

Alegra MCP Server
ERP Systems Databases
Dattics
A
license
B
quality
C
maintenance
A Model Context Protocol server that enables LLMs to securely interact with Alegra accounting API, allowing operations on invoices, contacts, and items data.
Updated 4 days ago (2026-11-09 14:10 UTC)
1
221 npm
1
ISC
Siigo MCP Server
ERP Systems Finance App Automation
jdlar1
A
license
B
quality
B
maintenance
Enables integration with Colombian accounting software Siigo through its API. Supports managing products, customers, invoices, purchases, credit notes, vouchers, payment receipts, journals, and generating financial reports.
Updated 21 days ago (2026-10-23 02:29 UTC)
49
35 npm
9
MIT
Siigo MCP Server
ERP Systems Finance Customer Data Platforms
dsfaccini
A
license
A
quality
D
maintenance
Unofficial MCP server for Siigo Colombian electronic invoicing software that enables AI to manage customers, products, invoices, credit notes, and journals through the Siigo API with configurable safety modes.
Updated 10 months ago (2025-12-30 03:42 UTC)
19
1
MIT
Siigo MCP Server
Finance ERP Systems
castrillon89
F
license
Not graded
quality
Not graded
maintenance
Enables interaction with the Siigo API to manage products, customers, and invoices with enterprise-grade security features like RBAC and audit logging. It supports financial reporting operations and secure data handling through the Model Context Protocol.
Updated 8 months ago (2026-03-15 23:42 UTC)
-

Siigo MCP Server

Features

Core Resources

Inventory Management

Catalogs

Reports

Installation

Option 1: NPX (Recommended - No Installation Required)

Option 2: Global Installation

Option 3: Local Development / Building from Source

Configuration

Required Environment Variables

Optional Environment Variables

Getting Siigo API Credentials

MCP Client Configuration

Claude Desktop

Available Tools (68 total)

Products (6 tools)

Account Groups / Inventory Categories (3 tools)

Customers (5 tools)

Invoices (10 tools)

Batch Invoices (1 tool)

Quotations (5 tools)

Credit Notes (4 tools)

Vouchers / Cash Receipts (3 tools)

Purchase Support Documents (5 tools)

Purchases (5 tools)

Payment Receipts / Disbursements (5 tools)

Journals / Accounting Entries (3 tools)

Webhooks (4 tools)

Catalogs (13 tools + account groups above)

Reports (3 tools)

Document Types Reference

Example Usage

Create a Quotation

Create a Combo Product

Create a Healthcare Invoice

Create Batch Invoices

API Rate Limits

Error Handling

Development

Project Structure

Building

Running for Development

Contributing

License

Support

Links

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Alegra MCP Server

Siigo MCP Server

Siigo MCP Server

Siigo MCP Server