mcp-tiny — Claude Code MCP server: Tiny ERP products, orders, invoices
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.
claude mcp add mcp-tiny -e TINY_API_TOKEN=<TINY_API_TOKEN> -- npx -y @codespar/mcp-tinyWhat mcp-tiny 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.
What it helps with
- 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 for the agent
- Show stock for product
SKU-142in every Tiny warehouse - Create the NF-e invoice for order
10231and give me the DANFE link - Mark order
10231as cancelled
How to install mcp-tiny
Platform CLI
claude mcp add mcp-tiny -e TINY_API_TOKEN=<TINY_API_TOKEN> -- npx -y @codespar/mcp-tinyReplace <…> with your own values
Platform CLI
codex mcp add tiny --env TINY_API_TOKEN=<TINY_API_TOKEN> -- npx -y @codespar/mcp-tinyReplace <…> with your own values
Config file
{
"mcpServers": {
"tiny": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-tiny"
],
"env": {
"TINY_API_TOKEN": "<TINY_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tiny": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-tiny"
],
"env": {
"TINY_API_TOKEN": "<TINY_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TINY_API_TOKEN=<TINY_API_TOKEN> tiny npx -y @codespar/mcp-tinyReplace <…> 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-tiny
How do I install mcp-tiny in Claude Code?
Run claude mcp add mcp-tiny -e TINY_API_TOKEN=<TINY_API_TOKEN> -- npx -y @codespar/mcp-tiny, replacing the placeholder with your Tiny token.
What does mcp-tiny do?
It hands your agent 21 Tiny ERP tools covering products, categories, warehouses, price lists, orders, contacts, stock, NF-e and NFC-e invoices, payables and receivables. Several of them change data rather than only reading it.
What do I need before running mcp-tiny?
An API token from your Tiny account, passed as TINY_API_TOKEN. The server starts via npx, so Node.js is required.
