Used for managing environment variables and configuration settings for Siigo API credentials
Used for package management and dependency installation in the Node.js-based MCP server implementation
Used as the programming language for implementing the MCP server with type safety
Siigo MCP Server
A Model Context Protocol (MCP) server that provides integration with the Siigo API, enabling access to Colombian accounting software features including products, customers, invoices, purchases, credit notes, vouchers, payment receipts, and journals.
Features
This MCP server provides access to all major Siigo API endpoints:
Core Resources
- Products: Create, read, update, and delete products/services 
- Customers: Manage customer/supplier information 
- Invoices: Handle sales invoices with electronic invoicing support 
- Purchases: Manage purchase invoices and expenses 
- Credit Notes: Create and manage credit notes 
- Vouchers: Handle cash receipts (recibos de caja) 
- Payment Receipts: Manage payment receipts/disbursements 
- Journals: Handle accounting journal entries 
Catalogs
- Document types, taxes, payment types 
- Cost centers, users, warehouses 
- Price lists, account groups, cities 
- ID types, fiscal responsibilities 
Reports
- Trial balance reports 
- Trial balance by third party 
- Accounts payable reports 
Installation
- Clone this repository: 
- Install dependencies: 
- Build the TypeScript code: 
- Set up environment variables by copying the example file: 
- Edit - .envwith your Siigo credentials:
Configuration
Required Environment Variables
- SIIGO_USERNAME: Your Siigo API username
- SIIGO_ACCESS_KEY: Your Siigo API access key
Optional Environment Variables
- SIIGO_BASE_URL: API base URL (defaults to- https://api.siigo.com)
- SIIGO_PARTNER_ID: Partner ID for API identification (defaults to- siigo-mcp-server)
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, you can use the sandbox environment 
Usage
Running the Server
Start the MCP server:
For development with auto-reload:
Available Tools
The server provides 40+ tools for interacting with the Siigo API. Here are some examples:
Products
- siigo_get_products- List all products
- siigo_get_product- Get a specific product by ID
- siigo_create_product- Create a new product
- siigo_update_product- Update an existing product
- siigo_delete_product- Delete a product
Customers
- siigo_get_customers- List all customers
- siigo_get_customer- Get a specific customer by ID
- siigo_create_customer- Create a new customer
- siigo_update_customer- Update an existing customer
Invoices
- siigo_get_invoices- List all invoices
- siigo_get_invoice- Get a specific invoice by ID
- siigo_create_invoice- Create a new invoice
- siigo_update_invoice- Update an existing invoice
- siigo_delete_invoice- Delete an invoice
- siigo_get_invoice_pdf- Get invoice PDF
- siigo_send_invoice_email- Send invoice by email
Catalogs
- siigo_get_document_types- Get document types
- siigo_get_taxes- Get tax information
- siigo_get_payment_types- Get payment methods
- siigo_get_cost_centers- Get cost centers
- siigo_get_users- Get system users
Reports
- siigo_get_trial_balance- Generate trial balance report
- siigo_get_accounts_payable- Get accounts payable report
Example Usage
Creating a Product
Creating a Customer
API Rate Limits
Siigo API has the following rate limits:
- Production: 100 requests per minute per company 
- Sandbox: 10 requests per minute 
Error Handling
The server handles various Siigo API errors and returns structured error responses. Common error scenarios include:
- Authentication failures 
- Invalid parameters 
- Rate limit exceeded 
- Resource not found 
- Validation errors 
Development
Project Structure
Building
Testing
Contributing
- Fork the repository 
- Create a feature branch 
- Make your changes 
- Add tests if applicable 
- Submit a pull request 
License
MIT License
Support
For issues related to:
- Siigo API: Contact Siigo support at soporteapi@siigo.com 
- This MCP server: Create an issue in this repository 
Links
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
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.