Mcp Tiny

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

MCP server for Tiny ERP — products, stock, warehouses, price lists, orders, invoices, AP/AR

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant read and change Tiny ERP business data such as products, orders, invoices, stock, and payables.

What you can do
Connects an assistant to Tiny ERP through 21 tools. It can list and fetch products, orders, contacts, invoices, warehouses, price lists, categories, and accounts payable or receivable. It can also act on that data: create a fiscal invoice (NF-e) from an order, adjust product stock balances, change a sales order's status, and email an issued invoice. Invoice XML and DANFE PDF links can be retrieved.
When to use it
Useful when an assistant needs to look up or update Tiny ERP records during everyday business work, for example checking stock or order status, reviewing invoices and payables, or issuing and sending invoices. It fits teams already running Tiny ERP who want conversational access to it.
Requirements
Runs locally as a stdio process, typically started with npx from the npm package @codespar/mcp-tiny, so Node.js and network access are needed. A Tiny ERP account and an API token are required, supplied through the TINY_API_TOKEN environment variable. Desktop client configuration is required.
Before you install
The TINY_API_TOKEN secret grants access to the Tiny ERP account and must be kept out of shared configuration files. Several tools write or send data: create_invoice issues a fiscal invoice, update_stock changes stock balances, update_order_status changes order state, and send_invoice_email sends mail to a recipient. Review these actions before letting an assistant run them.

Installation

In SourceWeft

  1. Open Mcp Tiny 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

@codespar/mcp-tiny

MCP server for Tiny ERP — products, orders, contacts, invoices, stock, and accounts payable

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "tiny": {      "command": "npx",      "args": ["-y", "@codespar/mcp-tiny"],      "env": {        "TINY_API_TOKEN": "your-token"      }    }  }}

Claude Code

bash
claude mcp add tiny -- npx @codespar/mcp-tiny

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "tiny": {      "command": "npx",      "args": ["-y", "@codespar/mcp-tiny"],      "env": {        "TINY_API_TOKEN": "your-token"      }    }  }}

Tools (21)

ToolPurpose
list_productsList products in Tiny ERP
get_productGet product details by ID
list_ordersList sales orders in Tiny ERP
get_orderGet order details by ID
list_contactsList contacts in Tiny ERP
get_contactGet contact details by ID
create_invoiceCreate a fiscal invoice (NF-e) from an order in Tiny
get_invoiceGet invoice details by ID
get_stockGet current stock for a product
list_accounts_payableList accounts payable in Tiny ERP
update_stockUpdate (adjust) product stock balance — credit or debit a quantity for a deposit
list_categoriesList product categories as a tree in Tiny ERP
list_warehousesList stock warehouses (depósitos) configured in Tiny ERP
list_price_listsList price lists (listas de preços) configured in Tiny ERP
update_order_statusChange a sales order's status — useful for cancelling or marking as approved/billed
list_invoicesList fiscal invoices (NF-e/NFC-e) in Tiny ERP
get_invoice_xmlGet the XML payload of an issued invoice (NF-e)
get_invoice_linkGet the DANFE PDF/link for an issued invoice
send_invoice_emailEmail an issued invoice to a recipient
list_accounts_receivableList accounts receivable in Tiny ERP
get_account_receivableGet a single accounts-receivable record by ID

Authentication

Tiny uses a token parameter passed in each request.

Sandbox / Testing

Tiny provides test access via account registration.

Get your credentials

  1. Go to Tiny ERP
  2. Create an account
  3. Navigate to API settings to generate a token
  4. Set the TINY_API_TOKEN environment variable

Environment Variables

VariableRequiredDescription
TINY_API_TOKENYesAPI token from Tiny ERP

Roadmap

v0.2 (planned)

  • create_product — Create a new product
  • update_product — Update product details
  • create_contact — Create a contact (customer/supplier)
  • update_contact — Update contact details
  • get_financial_summary — Get financial summary report

v0.3 (planned)

  • fiscal_reports — Generate fiscal reports (NF-e, NFS-e)
  • multi_company — Multi-company management

Want to contribute? Open a PR or request a tool.

Links

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.

License

MIT

Source: packages/erp/tiny/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