mcp-colppy — Claude Code MCP server: features and installation
Connect an agent to Colppy to manage invoices, customers, payments, stock and reports. The server needs a Colppy API key and company ID.
claude mcp add mcp-colppy -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppyWhat mcp-colppy does
mcp-colppy gives an agent access to Colppy operations. It can create and retrieve invoices, manage customer and supplier records, record payments, and check balances. Invoice creation connects to AFIP electronic invoicing. The server exposes 22 tools.
It can also return sales and expense reports, show product stock across warehouses, and retrieve an invoice PDF. Set COLPPY_API_KEY and COLPPY_COMPANY_ID before launch; Colppy uses the key with a session. This is an alpha release, and the API paths have not been fully tested against a live service, so pin an exact version.
What it helps with
- create an invoice with AFIP electronic invoicing
- find a customer or supplier in Colppy
- record a payment against an invoice
- get a sales report for a date range
- check product stock across warehouses
Example prompts for the agent
- Create a Colppy invoice for this customer and submit it for electronic invoicing.
- Show stock by warehouse and this customer's current balance.
- Prepare a sales report for the requested date range.
How to install mcp-colppy
Platform CLI
claude mcp add mcp-colppy -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppyReplace <…> with your own values
Platform CLI
codex mcp add colppy --env COLPPY_API_KEY=<COLPPY_API_KEY> --env COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppyReplace <…> with your own values
Config file
{
"mcpServers": {
"colppy": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-colppy"
],
"env": {
"COLPPY_API_KEY": "<COLPPY_API_KEY>",
"COLPPY_COMPANY_ID": "<COLPPY_COMPANY_ID>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"colppy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-colppy"
],
"env": {
"COLPPY_API_KEY": "<COLPPY_API_KEY>",
"COLPPY_COMPANY_ID": "<COLPPY_COMPANY_ID>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> colppy npx -y @codespar/mcp-colppyReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-colppy
How do I install mcp-colppy in Claude Code?
Run claude mcp add mcp-colppy -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppy. Replace the placeholders with your API key and company ID.
What does mcp-colppy do?
It connects an agent to Colppy through 22 tools for invoices, customer records, payments, stock and reports. Creating an invoice integrates with AFIP electronic invoicing.
What credentials does the server require?
Set COLPPY_API_KEY and COLPPY_COMPANY_ID before launch. Colppy sends the API key with the company ID.
