@codespar/mcp-alegra

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="[e-mail]"
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.