Summary
Siigo API for Siigo Nube, the Colombian accounting and electronic invoicing software: customers and suppliers, products, sales invoices with their DIAN status, quotations, credit notes, cash and payment receipts, journal vouchers, catalogs (document types, taxes, payment methods, cost centers, users, warehouses), trial balance and accounts payable. Username and access key.
Guided setup
Connect Siigo to Gemini in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Siigo in the guided setup, then add your MCP URL to Gemini. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Siigo
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Siigo, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Siigo + Gemini
Siigo API for Siigo Nube, the Colombian accounting and electronic invoicing software: customers and suppliers, products, sales invoices with their DIAN status, quotations, credit notes, cash and payment receipts, journal vouchers, catalogs (document types, taxes, payment methods, cost centers, users, warehouses), trial balance and accounts payable. Username and access key.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
SIIGO_USERNAME, SIIGO_ACCESS_KEY
Step 1 — Get credentials
Setting up takes about 3 minutes.
- Sign in to Siigo Nube as an administrator and open Alianzas in the left menu, then Mi Credencial API.
- Generate the credential and copy the username into
SIIGO_USERNAMEand the access key intoSIIGO_ACCESS_KEY.
The connector signs in at POST /auth with both values, receives a token that lasts 24 hours and renews it by itself. Every call carries the header Partner-Id: AnythingMCP, which Siigo requires to identify the integrating application.
Where to start: siigo_list_document_types (the invoice types of the company), siigo_list_users (sellers), siigo_list_payment_types and siigo_list_taxes: their ids are needed to create documents. siigo_list_invoices with a customer or a date range answers most sales questions.
Catalogs: siigo_list_document_types, siigo_list_taxes, siigo_list_payment_types, siigo_list_cost_centers, siigo_list_users, siigo_list_warehouses, siigo_list_account_groups. They rarely change: read each once per conversation.
Third parties and products: siigo_list_customers (filter by identification), siigo_get_customer, siigo_create_customer; siigo_list_products (filter by code), siigo_get_product, siigo_create_product.
Sales invoices: siigo_list_invoices, siigo_get_invoice, siigo_create_invoice, siigo_get_invoice_stamp_errors, siigo_send_invoice_email. siigo_create_invoice saves the invoice without sending it to the DIAN unless send_to_dian is true; an invoice the DIAN accepted has a cufe and can no longer be annulled or deleted, only corrected with a credit note. siigo_annul_invoice and siigo_delete_invoice are installed switched off. The public_url of an invoice is the printable view to share; the connector does not return PDF files.
Other documents (read only): siigo_list_quotations, siigo_get_quotation, siigo_list_credit_notes, siigo_get_credit_note, siigo_list_vouchers and siigo_get_voucher (cash receipts: money received), siigo_list_payment_receipts (money paid to suppliers), siigo_list_journals. The connector creates no receipts, credit notes or journal vouchers and moves no money.
Reports: siigo_generate_trial_balance and siigo_generate_trial_balance_by_third_party return a link to an Excel file, not figures. siigo_list_accounts_payable returns the open supplier dues as JSON.
Paging: lists return results, pagination (page, page_size, total_results) and _links. Ask for the next page while rows remain; page_size goes up to 100.
Formats: dates are yyyy-MM-dd; the created and updated filters also take UTC date-times. Document ids are GUIDs, catalog ids are numbers. A customer is addressed on documents by identification and branch_office, a product by code. Amounts are numbers in the local currency (COP) unless the document has a currency.
Errors are Status and Errors with Code, Message and Params: parameter_required and invalid_reference name the field or the id that does not exist, invalid_total_payments means the payments do not add up to the total, already_exists a duplicate code or identification, unauthorized a wrong or blocked credential.
Limits: 100 calls per minute per company (requests_limit). Siigo blocks an API user whose calls were more than 80 % errors over 7 days, so do not guess ids or codes: read them from the catalogs first.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
Siigotools.
Available tools
| Tool | What it does |
|---|---|
siigo_list_document_types | List the document types (comprobantes) configured in Siigo for one kind of document: id, code, name, description, whether it is electronic… |
siigo_list_taxes | List the taxes configured in Siigo: id, name, type (IVA, Retefuente, ReteIVA, ReteICA, Impoconsumo, AdValorem, Autorretencion), percentage… |
siigo_list_payment_types | List the payment methods (formas de pago) usable on one kind of document: id, name, type (Cartera, Proveedor, CarteraProveedor), active and… |
siigo_list_cost_centers | List the cost centers (centros de costo): id, code, name and active. Some document types require one on every invoice. Read-only |
siigo_list_users | List the Siigo users of the company: id, username, first_name, last_name, email, identification and active. The id of a user is the… |
siigo_list_warehouses | List the warehouses (bodegas) used for inventory: id, name, active and has_movements. Read-only |
siigo_list_account_groups | List the inventory classifications (grupos de inventario): id, name and active. A new product needs the id of one as account_group.… |
siigo_list_customers | List customers and other third parties (clientes, proveedores, terceros): id, type, person_type, id_type, identification, check_digit… |
siigo_get_customer | Read one third party in full: identification and type, names, VAT responsibility and fiscal responsibilities, address with country, state… |
siigo_create_customer | Create a third party (customer, supplier or other) in Siigo and return it with its id. Look it up first with siigo_list_customers by… |
siigo_list_products | List products and services, newest first: id, code, name, account_group, type (Product, Service, ConsumerGood), stock_control, active… |
siigo_get_product | Read one product or service in full: code, name, classification, type, taxes, prices, unit, description, additional fields (barcode, brand… |
siigo_create_product | Create a product or service in Siigo and return it with its id. The code must be unique; account_group is the id of an inventory… |
siigo_list_invoices | List sales invoices (facturas de venta): id, document type, number, name (such as FV-2-22), date, customer, cost_center, total, balance… |
siigo_get_invoice | Read one sales invoice in full: number and name, date, customer, seller, cost center, currency, every item with quantity, price, discount… |
siigo_create_invoice | Create a sales invoice in Siigo for an existing customer and return it with its id, number, total and public_url. By default the invoice is… |
siigo_get_invoice_stamp_errors | Read why the DIAN rejected an electronic invoice: errors with the message of each rejection. Use it when the stamp status of an invoice… |
siigo_send_invoice_email | Mail an existing sales invoice to up to 5 addresses. Returns status sent when Siigo accepted the request. Confirm the recipients with the… |
siigo_annul_invoice | Annul (anular) a sales invoice. Siigo refuses invoices already sent to or accepted by the DIAN (with a CUFE) and invoices with related… |
siigo_delete_invoice | Delete a sales invoice permanently. Siigo refuses invoices sent to or accepted by the DIAN and invoices with related documents. This cannot… |
siigo_list_quotations | List quotations (cotizaciones): id, number, name (such as C-1-22), date, customer, total, seller, items and public_url. Filter by name… |
siigo_get_quotation | Read one quotation in full: number, name, date, customer, seller, items with quantities, prices and taxes, total and public_url. Read-only |
siigo_list_credit_notes | List credit notes (notas credito): id, document type, number, name, date, the invoice each one corrects, customer, total, DIAN stamp, items… |
siigo_get_credit_note | Read one credit note in full: number, date, the invoice it corrects, customer, reason, items, payments, total and the DIAN stamp. Read-only |
siigo_list_vouchers | List cash receipts (recibos de caja), the record of money received from customers: id, document type, number, name, date, type, customer… |
siigo_get_voucher | Read one cash receipt (recibo de caja) in full: number, date, customer, the due invoices it pays with their values, payment method, cost… |
siigo_list_payment_receipts | List payment receipts (recibos de pago or egreso), the record of money paid to suppliers: id, document type, number, name, date, supplier… |
siigo_list_journals | List journal vouchers (comprobantes contables): id, document type, number, name, date and the debit and credit items with account, third… |
siigo_generate_trial_balance | Generate the general trial balance (balance de prueba) of a year for a range of months and accounts. Siigo builds an Excel file and returns… |
siigo_generate_trial_balance_by_third_party | Generate the trial balance by third party (balance de prueba por tercero) for a range of months and accounts, for all third parties or one.… |
siigo_list_accounts_payable | List accounts payable (cuentas por pagar): one row per open due amount with due (prefix, consecutive, quote, date, balance in local… |
Example prompts
- "List the sales invoices to customer NIT 900123456 from October with their DIAN status."
- "Why was invoice FV-1-2045 rejected by the DIAN?"
- "Create an invoice draft for Comercial Andina: 3 units of product CAF-500 at the list price."
- "Which supplier dues are open right now?"
- "Generate the trial balance for September."
FAQ
Where do the credentials come from? Sign in to Siigo Nube as an administrator, open Alianzas in the left menu, then Mi Credencial API, and generate the credential: the username goes into SIIGO_USERNAME, the access key into SIIGO_ACCESS_KEY. The connector signs in with both and renews its 24-hour token by itself.
What does it cover? Customers and suppliers, products, sales invoices with their DIAN status and stamp errors, sending invoices by e-mail, quotations, credit notes, cash and payment receipts, journal vouchers, the catalogs a document needs, the trial balance (as a link to an Excel file) and accounts payable. Credit notes, receipts and journal vouchers are read-only, and no tool moves money.
Which tools install switched off? siigo_annul_invoice and siigo_delete_invoice. Switch them on on the connector page only if the AI should use them. An invoice is only sent to the DIAN when send_to_dian is true; once accepted it can only be corrected with a credit note.
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?