# mcp-siigo

Gives your agent Siigo tools for invoices, credit notes, customers and products, with DIAN e-invoicing built in.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/colombia/siigo
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-siigo

## What it does

Twenty-two tools sit inside this server, all talking to the Siigo API. `create_invoice` writes an invoice and sends it to DIAN; `get_invoice_pdf` pulls the document itself; `create_credit_note` adjusts an invoice already issued. Customers and products are handled the same way — `create_customer`, `update_product`, `delete_product`. Reference data comes through too: document types, taxes, payment methods, warehouses, users.

Auth is a Bearer token. Both `SIIGO_API_KEY` and `SIIGO_ACCESS_TOKEN` are required, and the server won't start without them. Get credentials from the Siigo developer portal. Transport is stdio by default; set `MCP_HTTP="true"` together with `MCP_PORT` to switch to HTTP.

Node.js is all you need on the machine — the package runs via `npx`. It's listed for Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline and Zed, and only the config wrapper changes between them. An expired access token means invoices stop reaching DIAN, so keep the credential fresh.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SIIGO_API_KEY`, `SIIGO_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-siigo -e SIIGO_API_KEY=<SIIGO_API_KEY> -e SIIGO_ACCESS_TOKEN=<SIIGO_ACCESS_TOKEN> -- npx -y @codespar/mcp-siigo
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add siigo --env SIIGO_API_KEY=<SIIGO_API_KEY> --env SIIGO_ACCESS_TOKEN=<SIIGO_ACCESS_TOKEN> -- npx -y @codespar/mcp-siigo
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "siigo": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-siigo"
            ],
            "env": {
                "SIIGO_API_KEY": "<SIIGO_API_KEY>",
                "SIIGO_ACCESS_TOKEN": "<SIIGO_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "siigo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-siigo"
            ],
            "env": {
                "SIIGO_API_KEY": "<SIIGO_API_KEY>",
                "SIIGO_ACCESS_TOKEN": "<SIIGO_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SIIGO_API_KEY=<SIIGO_API_KEY> -e SIIGO_ACCESS_TOKEN=<SIIGO_ACCESS_TOKEN> siigo npx -y @codespar/mcp-siigo
```
Replace <…> with your own values

## When to use it
- issue a Siigo invoice and send it to DIAN
- fetch the PDF of an invoice you already created
- raise a credit note against an existing invoice
- add a customer or product straight from the chat
- check which warehouses and payment methods exist

## Example prompts
- Create an invoice for the last order and give me the PDF
- Make a credit note for last month's invoice
- Add this new customer, then fix their address

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md