mcpField
E
eqvitta-mcp

eqvitta-mcp

Local
github.com/EqvittaFinance0Updated 7w ago
Repository

About eqvitta-mcp

Eqvitta Accounting MCP Server connects Claude and other MCP clients to Eqvitta accounting records. It supports GST invoices, ledger and voucher operations, inventory queries, and financial reports, with access scoped by user roles and companies.

Key features

  1. 01Create GST sales and purchase invoices
  2. 02Search ledgers, balances, and statements
  3. 03Record receipt and payment vouchers
  4. 04Search stock and accounting groups
  5. 05Retrieve trial balance and financial statements
  6. 06Limit tools by role and company

Use cases

  1. 01Generate sales or purchase invoices
  2. 02Record customer receipts and supplier payments
  3. 03Check stock quantities and ledger balances
  4. 04Retrieve trial balance or profit and loss figures

MCP support

The MCP server exposes Eqvitta accounting operations as tools for Claude Desktop, Claude Code, and other MCP clients. It connects to Eqvitta's remote engine, and only makes tools authorized for the user's role available.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "eqvitta-eqvitta": {
      "command": "npx",
      "args": [
        "-y",
        "eqvitta-mcp"
      ],
      "env": {
        "EQVITTA_API_KEY": "<EQVITTA_API_KEY>"
      }
    }
  }
}
Run commandnpx -y eqvitta-mcp
Environment variables to set
EQVITTA_API_KEYSecretYour Eqvitta API key (generated in Eqvitta Settings > API Keys)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmeqvitta-mcp1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Eqvitta Accounting MCP Server

MCP Standard License: MIT Node Version

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

CategoryToolsDescription
Companies & Ledgerslist_companies, search_ledgers, get_ledger_balance, get_ledger_statement, update_ledger_contactExplore companies, query balances, and view statement entries.
Inventory & Catalogssearch_stocks, get_stock_detail, search_account_groupsSearch stock items, quantities, HSN/SAC codes, and accounting groups.
Invoicingcreate_sales_invoice, create_purchase_invoice, create_service_outward, create_service_inward, create_logistic_invoiceGenerate GST-compliant sales, purchase, service, and freight vouchers.
Receipts & Paymentscreate_receipt_voucher, create_payment_voucherRecord customer payments and supplier payouts against bank/cash accounts.
Financial Reportsget_trial_balance, get_financial_statementRetrieve structured balance sheet and profit & loss figures.
Challanssearch_challans, get_challan_detailTrack delivery and transport challans.
Admin Transfers (Gated)transfer_ledger_journal, transfer_group_balances_journal, bulk_transfer_transactions_ledgerShift 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.