Siigo MCP Server
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-mcpOption 2: Global Installation
npm install -g @jdlar/siigo-mcp
siigo-mcpOption 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 credentialsConfiguration
Required Environment Variables
Variable | Description |
| Your Siigo API username |
| Your Siigo API access key |
| Partner ID for API identification (3-100 alphanumeric chars, no spaces) |
Optional Environment Variables
Variable | Default | Description |
|
| 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 |
| List products with pagination | read-only |
| Get a product by ID | read-only |
| Create product (supports Combo type with components) | |
| Update a product | |
| Delete a product | destructive |
| Search by code, name, or reference (partial match) | read-only |
Account Groups / Inventory Categories (3 tools)
Tool | Description | Annotations |
| List inventory categories | read-only |
| Create inventory category | |
| Update inventory category |
Customers (5 tools)
Tool | Description | Annotations |
| List customers | read-only |
| Get a customer by ID | read-only |
| Create a customer/third party | |
| Update a customer | |
| Search by identification, name, or type | read-only |
Invoices (10 tools)
Tool | Description | Annotations |
| List invoices with date filters | read-only |
| Get an invoice by ID | read-only |
| Create invoice (supports healthcare and transport sectors) | |
| Update an invoice | |
| Delete an invoice | destructive |
| Annul (void) an invoice | destructive |
| Get invoice PDF (base64) | read-only |
| Get invoice electronic XML (base64) | read-only |
| Get DIAN rejection errors | read-only |
| Send invoice by email (up to 5 addresses) |
Batch Invoices (1 tool)
Tool | Description | Annotations |
| Create invoices in batch (async with webhook notification) |
Quotations (5 tools)
Tool | Description | Annotations |
| List quotations with date filters | read-only |
| Get a quotation by ID | read-only |
| Create a quotation (document type C) | |
| Update a quotation | |
| Delete a quotation | destructive |
Credit Notes (4 tools)
Tool | Description | Annotations |
| List credit notes | read-only |
| Get a credit note by ID | read-only |
| Create credit note (supports healthcare sector, external invoice refs) | |
| Get credit note PDF (base64) | read-only |
Vouchers / Cash Receipts (3 tools)
Tool | Description | Annotations |
| List cash receipts (recibos de caja) | read-only |
| Get a cash receipt by ID | read-only |
| Create cash receipt (DebtPayment, AdvancePayment, MiscIncome) |
Purchase Support Documents (5 tools)
Tool | Description | Annotations |
| List purchase support documents | read-only |
| Get a purchase support document by ID | read-only |
| Create purchase support document (document type DS) | |
| Update a purchase support document | |
| Delete a purchase support document | destructive |
Purchases (5 tools)
Tool | Description | Annotations |
| List purchase invoices | read-only |
| Get a purchase by ID | read-only |
| Create purchase (use FC type with | |
| Update a purchase | |
| Delete a purchase | destructive |
Payment Receipts / Disbursements (5 tools)
Tool | Description | Annotations |
| List payment receipts (recibos de pago / comprobantes de egreso) | read-only |
| Get a payment receipt by ID | read-only |
| Create payment receipt (DebtPayment, AdvancePayment, Advanced) | |
| Update a payment receipt | |
| Delete a payment receipt | destructive |
Journals / Accounting Entries (3 tools)
Tool | Description | Annotations |
| List accounting journals (comprobantes contables) | read-only |
| Get a journal by ID | read-only |
| Create journal entry (debits must equal credits) |
Webhooks (4 tools)
Tool | Description | Annotations |
| List webhook subscriptions | read-only |
| Subscribe to a webhook event | |
| Update a webhook subscription | |
| Delete a webhook subscription | destructive |
Catalogs (13 tools + account groups above)
Tool | Description |
| Document types (FV, RC, NC, FC, CC, RP, C, DS) |
| Taxes (IVA, Retefuente, ReteIVA, ReteICA, etc.) |
| Payment methods |
| Cost centers |
| Users/sellers |
| Warehouses |
| Price lists (up to 12) |
| Colombian cities |
| Expenses for cash receipt adjustments |
| Miscellaneous income concepts for cash receipts |
| Identification types |
| Fiscal responsibilities |
| Fixed assets |
Reports (3 tools)
Tool | Description |
| Trial balance report (Excel) |
| Trial balance by third party (Excel) |
| Accounts payable report |
Document Types Reference
Code | Spanish Name | English Name | MCP Support |
| Factura de Venta | Sales Invoice | Full CRUD + PDF/XML/Email/Batch/Annul |
| Recibo de Caja | Cash Receipt | Create + Query |
| Nota Credito | Credit Note | Create + Query + PDF |
| Factura de Compra | Purchase Invoice | Full CRUD |
| Comprobante Contable | Accounting Journal | Create + Query |
| Recibo de Pago/Egreso | Payment Receipt | Full CRUD |
| 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.mdBuilding
npm run buildRunning for Development
npm run devContributing
Fork the repository
Create a feature branch
Make your changes
Run
npm run buildto verifySubmit a pull request
License
MIT License
Support
Siigo API: Contact soporteapi@siigo.com
This MCP server: Create an issue
Links
Available Tools
49 toolssiigo_create_credit_noteC
Create a new credit note
Inputs: creditNote (required).
siigo_create_customerC
Create a new customer
Inputs: customer (required).
siigo_create_invoiceC
Create a new invoice
Inputs: invoice (required).
siigo_create_journalC
Create a new accounting journal
Inputs: journal (required).
siigo_create_payment_receiptC
Create a new payment receipt
Inputs: paymentReceipt (required).
siigo_create_productC
Create a new product
Inputs: product (required).
siigo_create_purchaseC
Create a new purchase
Inputs: purchase (required).
siigo_create_voucherC
Create a new voucher
Inputs: voucher (required).
siigo_delete_invoiceC
Delete an invoice
Inputs: id (required).
siigo_delete_payment_receiptC
Delete a payment receipt
Inputs: id (required).
siigo_delete_productC
Delete a product
Inputs: id (required).
siigo_delete_purchaseC
Delete a purchase
Inputs: id (required).
siigo_get_account_groupsB
Get account groups catalog
Inputs: no named parameters.
siigo_get_accounts_payableC
Get accounts payable report
Inputs: page, page_size.
siigo_get_citiesC
Get cities catalog
Inputs: no named parameters.
siigo_get_cost_centersC
Get cost centers catalog
Inputs: no named parameters.
siigo_get_credit_noteC
Get a specific credit note by ID
Inputs: id (required).
siigo_get_credit_notesC
Get list of credit notes from Siigo
Inputs: page, page_size.
siigo_get_customerB
Get a specific customer by ID
Inputs: id (required).
siigo_get_customersC
Get list of customers from Siigo
Inputs: page, page_size, type.
siigo_get_document_typesB
Get document types catalog
Inputs: type.
siigo_get_fiscal_responsibilitiesC
Get fiscal responsibilities catalog
Inputs: no named parameters.
siigo_get_id_typesB
Get ID types catalog
Inputs: no named parameters.
siigo_get_invoiceC
Get a specific invoice by ID
Inputs: id (required).
siigo_get_invoice_pdfC
Get invoice PDF
Inputs: id (required).
siigo_get_invoicesC
Get list of invoices from Siigo
Inputs: page, page_size, created_start, created_end.
siigo_get_journalC
Get a specific journal by ID
Inputs: id (required).
siigo_get_journalsC
Get list of accounting journals from Siigo
Inputs: page, page_size.
siigo_get_payment_receiptC
Get a specific payment receipt by ID
Inputs: id (required).
siigo_get_payment_receiptsB
Get list of payment receipts from Siigo
Inputs: page, page_size.
siigo_get_payment_typesB
Get payment types catalog
Inputs: document_type.
siigo_get_price_listsB
Get price lists catalog
Inputs: no named parameters.
siigo_get_productC
Get a specific product by ID
Inputs: id (required).
siigo_get_productsC
Get list of products from Siigo
Inputs: page, page_size.
siigo_get_purchaseC
Get a specific purchase by ID
Inputs: id (required).
siigo_get_purchasesC
Get list of purchases from Siigo
Inputs: page, page_size.
siigo_get_taxesC
Get taxes catalog
Inputs: no named parameters.
siigo_get_trial_balanceC
Get trial balance report
Inputs: year (required), month_start (required), month_end (required), includes_tax_difference (required), +2 more.
siigo_get_trial_balance_by_thirdC
Get trial balance by third party report
Inputs: year (required), month_start (required), month_end (required), includes_tax_difference (required), +3 more.
siigo_get_usersB
Get users catalog
Inputs: no named parameters.
siigo_get_voucherB
Get a specific voucher by ID
Inputs: id (required).
siigo_get_vouchersC
Get list of vouchers (cash receipts) from Siigo
Inputs: page, page_size.
siigo_get_warehousesC
Get warehouses catalog
Inputs: no named parameters.
siigo_send_invoice_emailC
Send invoice by email
Inputs: id (required), mail_to (required), copy_to.
siigo_update_customerC
Update an existing customer
Inputs: id (required), customer (required).
siigo_update_invoiceC
Update an existing invoice
Inputs: id (required), invoice (required).
siigo_update_payment_receiptC
Update an existing payment receipt
Inputs: id (required), paymentReceipt (required).
siigo_update_productC
Update an existing product
Inputs: id (required), product (required).
siigo_update_purchaseC
Update an existing purchase
Inputs: id (required), purchase (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 49 tools
Every tool has a clearly distinct purpose targeting specific resources and actions in the Siigo accounting/ERP domain. The naming convention (resource + action) makes it easy to distinguish between operations like create_invoice, get_invoice, update_invoice, and delete_invoice without ambiguity.
All tools follow a perfectly consistent 'siigo_verb_noun' pattern throughout the entire set. The structure is uniform with snake_case, consistent verb choices (create, get, update, delete), and clear resource naming, making the tool set highly predictable and readable.
With 49 tools, this server has far too many tools for typical MCP usage, creating cognitive overhead for agents. While comprehensive for an ERP system, the count feels excessive and could overwhelm agents trying to navigate the surface efficiently.
The tool set provides complete CRUD/lifecycle coverage for all major resources (customers, invoices, products, purchases, etc.), plus extensive catalog/report access and specialized operations like sending invoice emails. No obvious gaps exist for the accounting/ERP domain it serves.
Maintenance
Related MCP Connectors
Read invoices, orders, suppliers and payments; create and update clients and products in CBO.
Read invoices, incomes and expenses; create customers and providers in Cuéntica.
Read invoices, clients, products and stock; create clients and invoices in Facturis Online.
Issue, sign and manage Mexican CFDI 4.0 e-invoices, complements and credit notes.
Related MCP Servers
- AlicenseAqualityDmaintenanceUnofficial 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.1932 PyPI1MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- AlicenseAqualityDmaintenanceA 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.44MIT
- FlicenseNot gradedqualityDmaintenancePlataforma administrativa multi-cliente para conectar Siigo con paneles, automatizaciones y agentes de IA mediante MCP Streamable HTTP, ofreciendo herramientas para productos, clientes, cotizaciones e inventario.-