io.github.Eqvitta/eqvitta-mcp

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).

---

🛠️ 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.