@codespar/mcp-tiny
v0.1.0
Published
MCP server for Tiny ERP — products, orders, invoices, stock, accounts payable
Maintainers
Readme
@codespar/mcp-tiny
MCP server for Tiny ERP — products, orders, contacts, invoices, stock, and accounts payable
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"tiny": {
"command": "npx",
"args": ["-y", "@codespar/mcp-tiny"],
"env": {
"TINY_API_TOKEN": "your-token"
}
}
}
}Claude Code
claude mcp add tiny -- npx @codespar/mcp-tinyCursor / VS Code
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"servers": {
"tiny": {
"command": "npx",
"args": ["-y", "@codespar/mcp-tiny"],
"env": {
"TINY_API_TOKEN": "your-token"
}
}
}
}Tools
| Tool | Description |
|------|-------------|
| list_products | List products in Tiny ERP |
| get_product | Get product details by ID |
| list_orders | List sales orders in Tiny ERP |
| get_order | Get order details by ID |
| list_contacts | List contacts in Tiny ERP |
| get_contact | Get contact details by ID |
| create_invoice | Create a fiscal invoice (NF-e) from an order in Tiny |
| get_invoice | Get invoice details by ID |
| get_stock | Get current stock for a product |
| list_accounts_payable | List accounts payable in Tiny ERP |
Authentication
Tiny uses a token parameter passed in each request.
Sandbox / Testing
Tiny provides test access via account registration.
Get your credentials
- Go to Tiny ERP
- Create an account
- Navigate to API settings to generate a token
- Set the
TINY_API_TOKENenvironment variable
Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| TINY_API_TOKEN | Yes | API token from Tiny ERP |
Roadmap
v0.2 (planned)
create_product— Create a new productupdate_product— Update product detailscreate_contact— Create a contact (customer/supplier)update_contact— Update contact detailsget_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
License
MIT
