MCP Alegra

MCP server for Alegra — cloud accounting platform for LATAM (Colombian-founded), supporting invoicing, contacts, inventory, and payments across CO, MX, AR, CL, and more.

Quick Start

# Set your credentials
export ALEGRA_EMAIL="[email protected]"
export ALEGRA_API_TOKEN="your-api-token"

# Run via stdio
npx tsx packages/colombia/alegra/src/index.ts

# Run via HTTP
npx tsx packages/colombia/alegra/src/index.ts --http

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ALEGRA_EMAIL | Yes | Account email address | | ALEGRA_API_TOKEN | Yes | API token from Alegra settings | | MCP_HTTP | No | Set to "true" to enable HTTP transport | | MCP_PORT | No | HTTP port (default: 3000) |

Tools (20)

| Tool | Purpose | |---|---| | create_invoice | Create an invoice | | get_invoice | Get invoice details by ID | | list_invoices | List invoices | | void_invoice | Void/cancel an invoice | | get_invoice_pdf | Get invoice PDF download URL | | send_invoice | Email an invoice to one or more recipients | | create_contact | Create a contact (customer or supplier) | | update_contact | Update an existing contact | | delete_contact | Delete a contact | | list_contacts | List contacts | | create_item | Create a product or service item | | update_item | Update an existing item | | list_items | List products and services | | list_payments | List payments | | get_payment | Get payment by ID | | create_payment | Record a payment | | void_payment | Void/annul a payment | | list_categories | List item categories (chart of accounts) | | list_bank_accounts | List bank accounts | | get_company | Get company profile and settings |

Auth

Uses Basic authentication with email and API token. Obtain your API token from the Alegra settings page under "API" section.

API Reference

• Alegra API Docs

Enterprise? Contact us at codespar.com for dedicated support, custom integrations, and SLAs.