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 (
financialreporteditor or company_admin).
| 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.