io.github.Eqvitta/eqvitta-mcp
Eqvitta MCP: GST billing, ledgers, invoices, stock and financial reports for Claude.
Que pouvez-vous faire avec io.github.Eqvitta/eqvitta-mcp ?
- GST Invoicing:
- Ledgers & Account Groups:
- Vouchers & Transactions:
- Real-Time Financial Reports:
- Role-Based Security:
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
eqvitta-mcpclaude mcp add eqvitta-mcp -e 'EQVITTA_API_KEY=<your eqvitta_api_key>' -- npx -y eqvitta-mcp@1.0.1
{
"mcpServers": {
"eqvitta-mcp": {
"command": "npx",
"args": [
"-y",
"eqvitta-mcp@1.0.1"
],
"env": {
"EQVITTA_API_KEY": "<your eqvitta_api_key>"
}
}
}
}
Variables d'environnement
EQVITTA_API_KEYobligatoire secret Your Eqvitta API key (generated in Eqvitta Settings > API Keys)
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
Eqvitta Accounting MCP Server
Official Model Context Protocol (MCP) server for Eqvitta Cloud Accounting & GST Billing.
Connect Claude Desktop, Claude Code, and any MCP-compliant AI client directly to your Eqvitta accounting records. Seamlessly generate GST sales & purchase invoices, manage ledgers, post receipts & payments, query trial balances, and reconcile financial statements with strict role-based data isolation.
⚡ Quick Start with Claude Desktop
Automatic 1-Click Install (Smithery)
If using Smithery:
npx -y @smithery/cli install eqvitta-mcp --client claude
Manual Configuration
Add the server to your claude_desktop_config.json:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"eqvitta": {
"command": "npx",
"args": ["-y", "github:Eqvitta/eqvitta-mcp"],
"env": {
"EQVITTA_API_KEY": "YOUR_EQVITTA_API_KEY_HERE"
}
}
}
}
How to get your API Key: Log in to Eqvitta > Settings > API Keys > Generate a new Key.
🚀 Key Features
- GST Invoicing:
- Automatically calculates CGST, SGST, IGST, and rounding off.
- Automatically assigns the next sequential invoice number (e.g.
NR/2627/005). - Creates balanced double-entry ledger postings instantly.
- Ledgers & Account Groups:
- Look up ledgers, outstanding balances, party contact details, and account group structures.
- Vouchers & Transactions:
- Record Bank / Cash receipts and payments against customers, suppliers, and expense ledgers.
- Record outward and inward service invoices.
- Real-Time Financial Reports:
- Instant Trial Balance, Profit & Loss summaries, and Ledger Account Statements.
- Role-Based Security:
- Multi-tenant tenant isolation. All actions are scoped to companies the API key user is assigned to.
- Destructive operations (edits and deletions) are strictly disabled over MCP.
- Internal ledger transfers and financial adjustments require elevated administrative privileges (
financialreporteditororcompany_admin).
🛠️ Available MCP Tools
| Category | Tools | Description |
|---|---|---|
| Companies & Ledgers | list_companies, search_ledgers, get_ledger_balance, get_ledger_statement, update_ledger_contact | Explore companies, query balances, and view statement entries. |
| Inventory & Catalogs | search_stocks, get_stock_detail, search_account_groups | Search stock items, quantities, HSN/SAC codes, and accounting groups. |
| Invoicing | create_sales_invoice, create_purchase_invoice, create_service_outward, create_service_inward, create_logistic_invoice | Generate GST-compliant sales, purchase, service, and freight vouchers. |
| Receipts & Payments | create_receipt_voucher, create_payment_voucher | Record customer payments and supplier payouts against bank/cash accounts. |
| Financial Reports | get_trial_balance, get_financial_statement | Retrieve structured balance sheet and profit & loss figures. |
| Challans | search_challans, get_challan_detail | Track delivery and transport challans. |
| Admin Transfers (Gated) | transfer_ledger_journal, transfer_group_balances_journal, bulk_transfer_transactions_ledger | Shift ledger entries and transfer balances (only visible to authorized roles). |
🔒 Security & Architecture
The eqvitta-mcp CLI connects to Eqvitta's high-availability remote engine (https://chatapi.eqvitta.com/webhook/mcp).
- Zero Local Maintenance: All schema changes and accounting rule updates are managed on the cloud engine. Your client never requires manual version updates.
- Encrypted Communication: All traffic is encrypted over TLS 1.3.
- Least Privilege: Only tools authorized by the user's role are exposed to the AI model.
📄 License
MIT License. Copyright (c) 2026 Eqvitta Software Solutions.
Questions fréquentes
Qu'est-ce que io.github.Eqvitta/eqvitta-mcp ?
Eqvitta MCP: GST billing, ledgers, invoices, stock and financial reports for Claude.
Comment installer io.github.Eqvitta/eqvitta-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add eqvitta-mcp -e 'EQVITTA_API_KEY=<your eqvitta_api_key>' -- npx -y eqvitta-mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.Eqvitta/eqvitta-mcp ?
Oui. Il attend EQVITTA_API_KEY, à renseigner dans sa configuration.
io.github.Eqvitta/eqvitta-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.Eqvitta/eqvitta-mcp ?
Il est publié par Eqvitta. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.