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
.env
with your Siigo credentials:
Configuration
Required Environment Variables
SIIGO_USERNAME
: Your Siigo API usernameSIIGO_ACCESS_KEY
: Your Siigo API access key
Optional Environment Variables
SIIGO_BASE_URL
: API base URL (defaults tohttps://api.siigo.com
)SIIGO_PARTNER_ID
: Partner ID for API identification (defaults tosiigo-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 productssiigo_get_product
- Get a specific product by IDsiigo_create_product
- Create a new productsiigo_update_product
- Update an existing productsiigo_delete_product
- Delete a product
Customers
siigo_get_customers
- List all customerssiigo_get_customer
- Get a specific customer by IDsiigo_create_customer
- Create a new customersiigo_update_customer
- Update an existing customer
Invoices
siigo_get_invoices
- List all invoicessiigo_get_invoice
- Get a specific invoice by IDsiigo_create_invoice
- Create a new invoicesiigo_update_invoice
- Update an existing invoicesiigo_delete_invoice
- Delete an invoicesiigo_get_invoice_pdf
- Get invoice PDFsiigo_send_invoice_email
- Send invoice by email
Catalogs
siigo_get_document_types
- Get document typessiigo_get_taxes
- Get tax informationsiigo_get_payment_types
- Get payment methodssiigo_get_cost_centers
- Get cost centerssiigo_get_users
- Get system users
Reports
siigo_get_trial_balance
- Generate trial balance reportsiigo_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.