# mcp-tiny

Wires Tiny ERP into your coding agent: 21 tools for products, stock, warehouses, orders, NF-e invoices and receivables. Useful when ERP data should be reachable from chat.

- 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/erp/tiny
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-tiny

## What it does

The server exposes Tiny ERP to an agent through 21 tools. You can pull product and category trees, stock levels per warehouse, price lists, sales orders, contacts, fiscal invoices (NF-e and NFC-e), accounts payable and accounts receivable. Some tools write: adjust a stock balance for a deposit, move an order to another status, issue an invoice from an order, email it, fetch its XML or the DANFE link.

It runs through `npx`, so there is nothing to install globally. Tiny authenticates with a token sent on every request, and `TINY_API_TOKEN` has to be set or the server will not start. You generate that token in the API section of your Tiny account; test access comes from registering an account.

Creating and updating products or contacts, plus a financial summary report, sit on the v0.2 roadmap. Fiscal reports and multi-company support are planned for v0.3. So if your goal is to add a new product from the chat window, that is not available yet.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TINY_API_TOKEN` — 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-tiny -e TINY_API_TOKEN=<TINY_API_TOKEN> -- npx -y @codespar/mcp-tiny
```
Replace <…> with your own values

### Codex

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

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tiny": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-tiny"
            ],
            "env": {
                "TINY_API_TOKEN": "<TINY_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tiny": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-tiny"
            ],
            "env": {
                "TINY_API_TOKEN": "<TINY_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

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

## When to use it
- check stock levels across warehouses
- pull a list of sales orders
- issue an NF-e invoice from an order
- email an invoice to a customer
- review payables and receivables

## Example prompts
- Show stock for product `SKU-142` in every Tiny warehouse
- Create the NF-e invoice for order `10231` and give me the DANFE link
- Mark order `10231` as cancelled

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

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