How do I use TallyPrime MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@TallyPrime MCP Server show me the trial balance for this month" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

TallyPrime MCP Server

by anshveerturna

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

TallyPrime MCP Server

A production-grade Model Context Protocol (MCP) server that gives AI models complete, native-level control over TallyPrime ERP — covering every functional module across 169+ tools.

Architecture

                    ┌─ Stdio Transport (Claude Desktop / CLI)
AI Model ──► MCP ──┤
                    └─ StreamableHTTP (port 4000, remote clients)
                          │
                          ▼
                    TallyPrime XML Server (port 9000)
                          │
                    ├─ UTF-16LE encoded communication
                    ├─ Serial request queue (single-threaded safety)
                    ├─ Standard XML Export (Method A)
                    ├─ Inline TDL Queries (Method B)
                    ├─ XML Import (Method C)
                    ├─ TDL Actions (Method D)
                    └─ Object Export (Method E)

Three-Layer System

Layer	Purpose	Example
Standard XML API	CRUD operations, report exports	Create ledger, fetch Trial Balance
Inline TDL Queries	Complex filtered queries built programmatically	"All debtors with balance > 1L in Maharashtra"
Persistent TDL File	Pre-built collections loaded on Tally startup	`MCP Ledgers`, `MCP StockItems`, `MCP FinancialSnapshot`

Related MCP server: TallyPrime MCP Server

Quick Start

Prerequisites

TallyPrime running with XML Server enabled (port 9000)
Node.js 20+

Setup

# Clone & install
cd tally-mcp-server
npm install

# Configure
cp .env.example .env
# Edit .env with your Tally settings

# Run in development (HTTP mode)
npm run dev

# Run in Stdio mode (for Claude Desktop)
npm run dev:stdio

# Build & run production
npm run build
npm start          # HTTP mode
npm run start:stdio  # Stdio mode

Docker

docker compose up -d

Transport Modes

Stdio (for Claude Desktop / CLI)

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "tally": {
      "command": "node",
      "args": ["/path/to/tally-mcp-server/dist/index.js", "--stdio"]
    }
  }
}

Or set the environment variable:

MCP_TRANSPORT=stdio node dist/index.js

StreamableHTTP (for remote / web clients)

{
  "mcpServers": {
    "tally": {
      "url": "http://localhost:4000/mcp",
      "transport": "streamable-http"
    }
  }
}

Configuration

Variable	Default	Description
`TALLY_HOST`	`localhost`	TallyPrime hostname
`TALLY_PORT`	`9000`	TallyPrime XML server port
`TALLY_TIMEOUT_MS`	`30000`	Request timeout in ms
`TALLY_COMPANY`	(auto)	Force a specific company (optional)
`MCP_SERVER_PORT`	`4000`	HTTP transport port
`MCP_TRANSPORT`	`http`	Transport mode: `stdio` or `http`
`MASTER_CACHE_TTL_MS`	`300000`	Master cache TTL (5 min)
`LOG_LEVEL`	`info`	Winston log level

Tool Modules (169+ tools)

#	Module	Tools	Description
1	Masters	28	Ledgers, groups, stock items, units, godowns, cost centres, currencies
2	Vouchers	16	Sales, purchases, receipts, payments, journals, contra, credit/debit notes
3	Orders	10	Sales/purchase orders, delivery/receipt notes, rejections
4	Financial Reports	15	Trial balance, P&L, balance sheet, cash flow, daybook, ratio analysis
5	Inventory Reports	10	Stock summary, movement, batch, expiry, reorder, valuation
6	Outstanding	8	Receivables, payables, ageing analysis, bill-wise, overdue
7	GST	18	GSTR-1/2A/2B/3B, HSN, e-Invoice, e-Way Bill, ITC, reconciliation
8	TDS/TCS	12	Computation, forms 26Q/27Q/16, challans, PAN verification
9	Payroll	20	Employees, pay heads, salary structures, payslips, PF/ESI/gratuity
10	Manufacturing	14	BOM, production, consumption, job costing, yield analysis
11	Banking	10	Bank reconciliation, cheque register, PDC, cash position
12	Budgets	8	Budget CRUD, variance, utilization, scenario reports
13	Security	8	Users, audit trail, altered/deleted voucher logs, exceptions
14	Company	8	Company info, connection test, cache refresh, feature status
15	Bulk Operations	12	Batch create/update/delete masters & vouchers
16	TDL Query Engine	12	Custom queries, inline TDL, functions, raw XML, search, reference

Key Technical Features

UTF-16LE encoding — Correct wire encoding for Tally's XML server (supports Indian languages: Hindi, Tamil, etc.)
Serial request queue — All requests are serialized to protect Tally's single-threaded XML server from concurrent request crashes
EXCEPTION/LINEERROR/STATUS detection — Comprehensive error detection covering all Tally error response formats
Master name cache with TTL — Fast ledger/stock/group name lookups without hitting Tally
Persistent TDL file — Pre-built optimized collections loaded on Tally startup
Tally value parsers — Correct parsing of Tally's date, amount, quantity, rate, and boolean formats
Input validation — Zod schemas with GSTIN/PAN/date format validators
Structured logging — Winston logger with configurable levels

Persistent TDL File

Install tdl/tally-mcp.tdl in your TallyPrime TDL folder for optimized pre-built collections:

Collection	Contents
`MCP Ledgers`	All ledgers with key financial fields
`MCP StockItems`	All stock items with inventory fields
`MCP Groups`	All account groups
`MCP Vouchers`	All vouchers (date-filtered via SV)
`MCP Debtors`	Sundry Debtors with balances
`MCP Creditors`	Sundry Creditors with balances
`MCP BankAccounts`	Bank accounts with balances
`MCP CostCentres`	Cost centres
`MCP Employees`	All employees with details
`MCP CashBankSummary`	Cash + bank position
`MCP FinancialSnapshot`	Quick financial summary function

API Endpoints (HTTP mode only)

Endpoint	Method	Description
`/mcp`	POST	MCP StreamableHTTP transport
`/mcp`	GET	SSE stream (session-based)
`/mcp`	DELETE	Close session
`/health`	GET	Health check + cache stats

Project Structure

tally-mcp-server/
├── src/
│   ├── index.ts              # Entry point (Stdio + HTTP)
│   ├── server.ts             # MCP server factory
│   ├── tally/
│   │   ├── client.ts         # HTTP client (UTF-16LE, serial queue)
│   │   ├── xml-builder.ts    # XML request builders
│   │   ├── xml-parser.ts     # XML response parser + value helpers
│   │   ├── tdl-builder.ts    # Inline TDL builder
│   │   └── state.ts          # Master cache with TTL
│   ├── tools/                # 16 tool modules (169+ tools)
│   └── utils/
│       ├── logger.ts         # Winston logger
│       ├── validators.ts     # GSTIN/PAN/date validators
│       ├── date-utils.ts     # Date utilities
│       └── helpers.ts        # Shared result/error helpers
├── tdl/
│   └── tally-mcp.tdl        # Persistent TDL file
├── package.json
└── tsconfig.json

License

MIT

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/anshveerturna/tally-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server