Mcp Alegra

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

Alegra — cloud accounting for LATAM (Colombian-founded)

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Alegra, the LATAM cloud accounting platform, letting an assistant manage invoices, contacts, items, and payments.

What you can do
  • Create, list, fetch, void and email invoices, and get invoice PDF download links
  • Create, update, delete and list contacts (customers or suppliers)
  • Create, update and list product and service items
  • Record, list, fetch and void payments
  • List item categories, bank accounts, and read the company profile and settings
When to use it
Useful when you work with Alegra accounting in Colombia, Mexico, Argentina, Chile or similar markets and want an assistant to draft invoices, look up contacts and payments, or check company settings without switching to the web app.
Requirements
Runs as a local process via npx (Node.js). Requires an Alegra account and two environment variables: ALEGRA_EMAIL and the secret ALEGRA_API_TOKEN, obtained from the Alegra settings API section. Optional MCP_HTTP and MCP_PORT enable an HTTP transport. Network access to the Alegra API is needed.
Before you install
The server holds an Alegra API token that grants access to accounting data. Several tools write or change records: creating, voiding and emailing invoices, creating, updating and deleting contacts, creating and updating items, and recording or voiding payments. Emailing an invoice sends it to external recipients. Review write actions before letting an assistant run them.

Installation

In SourceWeft

  1. Open Mcp Alegra in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
# Set your credentialsexport ALEGRA_EMAIL="[email protected]"export ALEGRA_API_TOKEN="your-api-token"
# Run via stdionpx tsx packages/colombia/alegra/src/index.ts
# Run via HTTPnpx tsx packages/colombia/alegra/src/index.ts --http

Environment Variables

VariableRequiredDescription
ALEGRA_EMAILYesAccount email address
ALEGRA_API_TOKENYesAPI token from Alegra settings
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (20)

ToolPurpose
create_invoiceCreate an invoice
get_invoiceGet invoice details by ID
list_invoicesList invoices
void_invoiceVoid/cancel an invoice
get_invoice_pdfGet invoice PDF download URL
send_invoiceEmail an invoice to one or more recipients
create_contactCreate a contact (customer or supplier)
update_contactUpdate an existing contact
delete_contactDelete a contact
list_contactsList contacts
create_itemCreate a product or service item
update_itemUpdate an existing item
list_itemsList products and services
list_paymentsList payments
get_paymentGet payment by ID
create_paymentRecord a payment
void_paymentVoid/annul a payment
list_categoriesList item categories (chart of accounts)
list_bank_accountsList bank accounts
get_companyGet 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

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

  • ALEGRA_EMAIL (required) — Account email for Alegra
  • ALEGRA_API_TOKEN (required, secret) — API token for Alegra

Issue credentials at the provider's developer portal: https://developer.alegra.com.

License

MIT

Source: packages/colombia/alegra/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts