tally-mcp-server

Tally Prime MCP Server

Tally Prime MCP (Model Context Protocol) Server implementation to feed Tally Prime ERP data to popular LLM like Claude, ChatGPT supporting MCP client. This MCP Server helps expose functionalities of Tally to LLM directly.

Prerequisites

Tally Prime (Silver / Gold)
Node JS

Ensure below things are pre-installed and setup:

Ensure to download & install Node JS from official website
XML Port of Tally Prime must be enabled (F1 > Settings > Connectivity > Client/Server configuration) with below settings

TallyPrime acts as = Server
Port = 9000

Note: Kindly avoid using Educational version of Tally Prime, which has limitations of date range. It will result in invalid / partial data being fed to LLM, leading to highly degraded & incorrect responses.

Installation

Clone the repository and install dependencies:

git clone https://github.com/JINA-CODE-SYSTEMS/tally-mcp-server.git
cd tally-mcp-server
npm install
npx tsc

Supported Platform

Implementation was tested on below AI platform

Platform	Local	Remote
Claude AI	:heavy_check_mark:	:heavy_check_mark:
ChatGPT		:heavy_check_mark:

Claude Desktop

Desktop version of Claude AI supports loading of local MCP server. Ensure you have Pro / Team / Max / Enterprise subscription of Claude, which supports higher limit compared to Free. MCP makes multiple calls to Tally for validation and inference, which might exhaust free limits quickly. Download Claude Desktop from following link
claude.ai/download

Go to menu > File > Settings > Developer

This will open My Computer window. Right click and edit claude_desktop_config.json file (via Notepad) with as below JSON

{
  "mcpServers": {
	  "Tally Prime": {
		  "command": "node",
		  "args": ["D:\\Software\\Tally MCP Server\\dist\\index.mjs"]
	  }
  }
}

Note: single slash in folder path needs to be substituted with double slash

Save the file. Close Claude Desktop (menu > File > Exit) and again re-launch it.

Verify by clicking on Tools button and check if Tally Prime appears in the list.

Perplexity Desktop

Perplexity Desktop version for MacOS supports connecting to local MCP server. Configuration file (JSON format) is same as demonstrated for Claude Desktop. In absense of MacBook, documentation with screenshot could not be written. Kindly refer to below blog on perplexity website, which explains the steps.

Perplexity Desktop MCP Connectivity

Setup (Cloud)

This mode of setup is to be used, when using browser-based MCP client like ChatGPT, Claude AI, Copilot, OR mobile-based app for these LLM which cannot access Tally Prime running inside local PC. In this scenario, MCP Server needs to run as web-server, internally connected to Tally securely. Setup is quite complicated, and is covered in detail in docs folder of this project.

Linux-based Server
Windows Server (exploration in-progress)

list-master

Extracts list of specific master for auto-completion and validation if master exists, during inference by LLM

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
collection	Valid collection of Tally

Output
List (or array) of queries master

Collections that can be queried:

Group
Ledger
VoucherType
Unit
Godown
StockGroup
StockItem
CostCentre
CostCategory
AttendanceType
Company
Currency
GSTIN
GSTClassification

chart-of-accounts

Extracts Chart of Accounts (or Group hierarchy) useful for preparing Balance Sheet, Profit and Loss, Trial Balance

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company

Output
Tabular output with columns as below

Column	Description
group	Ledger name
parent	Group under which ledger exists
bs_pl	BS (Balance Sheet) / PL (Profit & Loss)
dr_cr	D (Debit) / C (Credit)
affects_gross_profit	Y (Yes) / N (No)

trial-balance

Extracts Trial Balance for the specified period

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
fromDate	Period start date (useful for opening balance)
toDate	Period end date for closing balance

Output
Tabular output with columns as below

Column	Description
ledger	Ledger name
group	Group under which ledger exists
opening_balance	Opening Balance for the specified fromDate
net_debit	Net Debit during the specified period
net_credit	Net Credit during the specified period
closing_balance	Closing Balance for the specified fromDate

balance-sheet

Extracts Balance Sheet as on date

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
toDate	as on date of Balance Sheet

Output
Tabular output with columns as below

Column	Description
ledger	Ledger name
group	Group under which ledger exists
closing_balance	Closing Balance as on date

profit-loss

Extracts Profit & Loss for the period

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
fromDate	Period start date
toDate	Period end date

Output
Tabular output with columns as below

Column	Description
ledger	Ledger name
group	Group under which ledger exists
amount	Amount of net activity (-ve = Expense / +ve = Income)

ledger-balance

Returns closing balance of ledger as on specified date

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
ledgerName	Ledger of which to query balance
toDate	specific date for closing balance

Output
Closing Balance of ledger (if exists)

Sign	Description
Negative (-)	Debit
Positive (+)	Credit

Note: If specified ledger does not exists, LLM might invoke list-master tool to fetch list of ledgers. It will attempt to find closest possible ledger name for this list and re-run this action. This might produce un-predictable response.

ledger-account

Extracts ledger account for the specified ledger for the given period

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
ledgerName	Ledger of which to query balance
fromDate	period start date
toDate	period end date

Output
Tabular output with columns as below

Column	Description
date	Date of voucher
voucher_type	Voucher Type
voucher_number	Voucher Number
party_ledger	Party ledger or opposite side ledger
amount	Amount (negative = Debit / positive = Credit)
narration	Narration or Remarks of voucher

stock-item-balance

Returns available quantity of stock item as on specified date

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
itemName	Stock Item of which to query available quantity
toDate	specific date as on which to check quantity

Output
Available Quantity of stock item (if exists)

Note: If specified stock item does not exists, LLM might invoke list-master tool to fetch list of stock items. It will attempt to find closest possible stock item name for this list and re-run this action. This might produce un-predictable response.

stock-item-account

Extracts account statement for stock item vouchers for the specified item for the given period

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
itemName	Ledger of which to query balance
fromDate	period start date
toDate	period end date

Output
Tabular output with columns as below

Column	Description
date	Date of voucher
voucher_type	Voucher Type
voucher_number	Voucher Number
party_ledger	Party ledger or opposite side ledger
quantity	Quantity (negative = Outward / positive = Inward)
amount	Amount (negative = Debit / positive = Credit)
narration	Narration or Remarks of voucher
tracking_number	Tracking number to reconcile pending quantity received by ignoring excess / missing quantity in actual purchase (against receipt note) and sales (against delivery note)

bills-outstanding

Extracts bill-wise outstanding Receivables / Payables report

Input

Argument	Description
targetCompany (optional)	Company name of the target company in Tally. Skipping this defaults to Active company
nature	receivable / payable
toDate	Date on which outstanding position to fetch

Output
Tabular output with columns as below

Column	Description
date	Date of purchase / sales invoice
reference_number	Invoice number of purchase / sales invoice
outstanding_amount	Pending amount as on date
party_name	Ledger name of the party
overdue_days	Count of days by which invoice is overdue

Credits

Originally created by Dhananjay Gokhale. This fork is maintained by Jinacode Systems.

Repository

JINA-CODE-SYSTEMS

JINA-CODE-SYSTEMS/tally-mcp-server

Created

April 13, 2026

Updated

April 13, 2026

Language

TypeScript

tally-mcp-server

Tally Prime MCP Server

Prerequisites

Installation

Supported Platform

Claude Desktop

Perplexity Desktop

Setup (Cloud)

list-master

chart-of-accounts

trial-balance

balance-sheet

profit-loss

ledger-balance

ledger-account

stock-item-balance

stock-item-account

bills-outstanding

Credits

Repository

Created

Updated

Language

Category