# mcp-colppy

Connect an agent to Colppy to manage invoices, customers, payments, stock and reports. The server needs a Colppy API key and company ID.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/argentina/colppy
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-colppy

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `COLPPY_API_KEY`, `COLPPY_COMPANY_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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 <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add colppy --env COLPPY_API_KEY=<COLPPY_API_KEY> --env COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> -- npx -y @codespar/mcp-colppy
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e COLPPY_API_KEY=<COLPPY_API_KEY> -e COLPPY_COMPANY_ID=<COLPPY_COMPANY_ID> colppy npx -y @codespar/mcp-colppy
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md