Skip to content
Back to search

tally-mcp-server

Tally Prime MCP (Model Context Protocol) Server implementation to feed Tally ERP data to popular LLM like Claude, ChatGPT supporting MCP

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dhananjay1405/tally-mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dhananjay1405/tally-mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dhananjay1405--tally-mcp-server/badge.svg)](/listings/dhananjay1405--tally-mcp-server)

HTML

<a href="/listings/dhananjay1405--tally-mcp-server"><img src="/api/listings/dhananjay1405--tally-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This mode of setup is to be used when MCP Client (like Claude Desktop, Perplexity etc.) and Tally Prime both exists in local PC. MCP Client software itself runs the MCP Server internally in such scenario.

Simply download &amp; extract zip file somewhere on the disk. Assuming that we downloaded &amp; extracted zip file on below path (folder)

D:\Software\Tally MCP Server

<image src="https://excelkida.com/image/github/explorer-tally-mcp-server.png" height="265" width="766" />

A sample setup for few popular tools is demonstrated.

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](https://claude.ai/download)

One-click installation (via Extension)

Go to menu &gt; File &gt; Settings

<image src="https://excelkida.com/image/github/claude-desktop-settings-menu.png" height="185" width="335">

Extensions &gt; Advance Settings

<image src="https://excelkida.com/image/github/claude-desktop-settings-extension.png" height="553" width="928">

Click on install extension button

<image src="https://excelkida.com/image/github/claude-desktop-extension-page.png" height="619" width="868">

Browse the extension file (with file extension mcpb) download at the start

<image src="https://excelkida.com/image/github/claude-desktop-extension-install.png" height="843" width="696">

A dialog window will appear asking *Do you want to install Tally Prime?* click **Install** button, which would install the Tally MCP Server

Installation via Config file (via Developer menu)

Go to menu &gt; File &gt; Settings &gt; Developer

<image src="https://excelkida.com/image/github/claude-desktop-developer-setting.png" height="751" width="1045" />

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 &gt; File &gt; Exit) and again re-launch it.

Verify by clicking on Tools button and check if Tally Prime appears in the list (screenshot below)

<image src="https://excelkida.com/image/github/claude-desktop-tally-mcp-server-tool-display.png" height="595" width="722" />

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](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 505 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Tally Prime MCP Server
  2. 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.
  3. ## Prerequisites
  4. * Tally Prime (Silver / Gold)
  5. * Node JS
  6. Ensure below things are pre-installed and setup:
  7. * Ensure to [download & install Node JS](https://nodejs.org/en) from official website
  8. * XML Port of Tally Prime must be enabled (F1 &gt; Settings &gt; Connectivity &gt; Client/Server configuration) with below settings
  9. ```
  10. TallyPrime acts as = Server
  11. Port = 9000
  12. ```
  13. *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 &amp; incorrect responses.*
  14. ## Download
  15. Avoid cloning repository directly. Utility is available for download (with required dependencies) on below link <br>
  16. [https://excelkida.com/resource/tally-mcp-server-v7.12.zip](https://excelkida.com/resource/tally-mcp-server-v7.12.zip)
  17. One-click installer **extension** for **Claude Desktop**<br>
  18. [https://excelkida.com/resource/tally-mcp-server-v7.12.mcpb](https://excelkida.com/resource/tally-mcp-server-v7.12.mcpb)
  19. Last updated: version **7.12** [25-Oct-2026]
  20. Refer docs/CHANGELOG.md for details
  21. ## Contact
  22. Project developed & maintained by:
  23. **Dhananjay Gokhale** <br>
  24. (Chartered Accountant)
  25. Email: **info@excelkida.com** <br>
  26. Whatsapp: **(+91) 90284-63366**
  27. ## Supported Platform
  28. Implementation was tested on below AI platform
  29. |Platform|Local|Remote|
  30. |--|--|--|
  31. |Claude AI| :heavy_check_mark: | :heavy_check_mark: |
  32. |ChatGPT| :heavy_check_mark: | :heavy_check_mark: |
  33. |Grok|| :heavy_check_mark: |
  34. |Mistral|| :heavy_check_mark: |
  35. |LM Studio| :heavy_check_mark: ||
  36. ## Setup (Local)
  37. This mode of setup is to be used when MCP Client (like Claude Desktop, Perplexity etc.) and Tally Prime both exists in local PC. MCP Client software itself runs the MCP Server internally in such scenario.
  38. Simply download &amp; extract zip file somewhere on the disk. Assuming that we downloaded &amp; extracted zip file on below path (folder)
  39. ```
  40. D:\Software\Tally MCP Server
  41. ```
  42. <image src="https://excelkida.com/image/github/explorer-tally-mcp-server.png" height="265" width="766" />
  43. A sample setup for few popular tools is demonstrated.
  44. ### Claude Desktop
  45. Video tutorial: [Claude Desktop (extension)](https://www.youtube.com/watch?v=0xeVSe2otJM)
  46. 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
  47. [claude.ai/download](https://claude.ai/download)
  48. #### One-click installation (via Extension)
  49. Go to menu &gt; File &gt; Settings
  50. <image src="https://excelkida.com/image/github/claude-desktop-settings-menu.png" height="185" width="335">
  51. Extensions &gt; Advance Settings
  52. <image src="https://excelkida.com/image/github/claude-desktop-settings-extension.png" height="553" width="928">
  53. Click on install extension button
  54. <image src="https://excelkida.com/image/github/claude-desktop-extension-page.png" height="619" width="868">
  55. Browse the extension file (with file extension mcpb) download at the start
  56. <image src="https://excelkida.com/image/github/claude-desktop-extension-install.png" height="843" width="696">
  57. A dialog window will appear asking *Do you want to install Tally Prime?* click **Install** button, which would install the Tally MCP Server
  58. #### Installation via Config file (via Developer menu)
  59. Go to menu &gt; File &gt; Settings &gt; Developer
  60. <image src="https://excelkida.com/image/github/claude-desktop-developer-setting.png" height="751" width="1045" />
  61. This will open My Computer window. Right click and edit **claude_desktop_config.json** file (via Notepad) with as below JSON
  62. ```json
  63. {
  64. "mcpServers": {
  65. "Tally Prime": {
  66. "command": "node",
  67. "args": ["D:\\Software\\Tally MCP Server\\dist\\index.mjs"]
  68. }
  69. }
  70. }
  71. ```
  72. *Note: single slash in folder path needs to be substituted with double slash*
  73. Save the file. Close Claude Desktop (menu &gt; File &gt; Exit) and again re-launch it.
  74. Verify by clicking on Tools button and check if Tally Prime appears in the list (screenshot below)
  75. <image src="https://excelkida.com/image/github/claude-desktop-tally-mcp-server-tool-display.png" height="595" width="722" />
  76. ### ChatGPT Desktop
  77. Video tutorial: [ChatGPT Desktop](https://www.youtube.com/watch?v=RU1xmQilO1o)
  78. Download &amp; install ChatGPT Desktop from Microsoft Store. Login to it.
  79. Go to Edit &gt; Settings
  80. Navigate to Integration &gt; Plugins. Click **Add** button and choose **Add MCP Server**
  81. <image src="https://excelkida.com/image/github/chatgpt-desktop-plugin-add-mcp.png" height="798" width="1228">
  82. In the MCP settings page enter / apply below options or values <br>
  83. **Name** = *Tally Prime* (or any other value) <br>
  84. **Command to launch** = *node* <br>
  85. **Arguments** = *D:\\Software\\Tally MCP Server\\dist\\index.mjs* (or other path)
  86. <image src="https://excelkida.com/image/github/chatgpt-desktop-stdio-settings.png" height="884" width="866">
  87. Click **Save** button
  88. Close &amp; Re-Open ChatGPT Desktop app
  89. ## Setup (Cloud)
  90. 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.
  91. * [Linux-based Server](docs/server-setup-linux.md)
  92. * Windows Server (exploration in-progress)
  93. ## Available Tools
  94. This server currently exposes 20 MCP tools.
  95. ### metadata-collection
  96. Returns metadata for supported collections.
  97. **Input**
  98. No input.
  99. **Output**
  100. JSON array with objects containing:
  101. 1. `collection`
  102. 1. `description`
  103. ### query-option-values
  104. Returns predefined option values used by input fields.
  105. **Input**
  106. |Argument|Description|
  107. |--|--|
  108. |optionName|Supported: `country-state`|
  109. **Output**
  110. JSON array of option values for the selected option name.
  111. ### metadata-fields
  112. Returns field metadata for a selected collection.
  113. **Input**
  114. |Argument|Description|
  115. |--|--|
  116. |collection|Collection name. Use `metadata-collection` to discover valid values|
  117. **Output**
  118. JSON array of field metadata containing field name, description (if any), and normalized datatype (`string`, `number`, `date`, `boolean`).
  119. ### query-database
  120. Runs SQL query on in-memory pglite tables previously created by reporting tools.
  121. **Input**
  122. |Argument|Description|
  123. |--|--|
  124. |sql|SELECT query only|
  125. |outputFormat|One of `JSON Array of Objects`, `JSON with Schema and Rows`, `CSV`, `Markdown Table`. Default is JSON Array of Objects which is preferred format|
  126. **Output**
  127. Query result in tab-separated text format.
  128. ### query-collection
  129. Queries a Tally collection for selected fields and caches output in an in-memory table.
  130. **Input**
  131. |Argument|Description|
  132. |--|--|
  133. |collection|Collection name|
  134. |fields|Array of field names to fetch|
  135. |targetCompany (optional)|Company name (defaults to active company)|
  136. |fromDate (optional)|Date in YYYY-MM-DD|
  137. |toDate (optional)|Date in YYYY-MM-DD|
  138. **Output**
  139. JSON: `{ "tableID": "..." }`
  140. ### list-master
  141. Fetches list of masters for validation and auto-completion.
  142. **Input**
  143. |Argument|Description|
  144. |--|--|
  145. |targetCompany (optional)|Company name (defaults to active company)|
  146. |collection|One of: `group`, `ledger`, `vouchertype`, `unit`, `godown`, `stockgroup`, `stockitem`, `costcategory`, `costcentre`, `attendancetype`, `company`, `currency`, `gstin`, `gstclassification`|
  147. |containsFilter (optional)|filter to apply CONTAINS operation to restrict values|
  148. **Output**
  149. JSON: `{ "list": [ ... ] }`
  150. ### chart-of-accounts
  151. Extracts Chart of Accounts (or Group hierarchy) useful for preparing Balance Sheet, Profit and Loss, Trial Balance
  152. **Input**
  153. |Argument|Description|
  154. |--|--|
  155. |targetCompany (optional)|Company name (defaults to active company)|
  156. **Output**
  157. JSON: `{ "tableID": "..." }` with columns:
  158. 1. `ledger_name`
  159. 1. `group_name`
  160. 1. `primary_group`
  161. 1. `bs_pl` (boolean) [**true** = Profit &amp; Loss / **false** = Balance Sheet]
  162. 1. `dr_cr` (boolean) [**true** = Debit / **false** = Credit]
  163. 1. `affects_gross_profit` (boolean) [**true** = Affects Gross Profit / **false** = Does not affect Gross Profit]
  164. 1. `sort_position` (number)
  165. ### trial-balance
  166. Fetches trial balance for period.
  167. **Input**
  168. |Argument|Description|
  169. |--|--|
  170. |targetCompany (optional)|Company name (defaults to active company)|
  171. |fromDate|Date in YYYY-MM-DD|
  172. |toDate|Date in YYYY-MM-DD|
  173. |group_name (optional)|Filter by group name|
  174. **Output**
  175. JSON: `{ "tableID": "..." }` with columns:
  176. 1. `ledger_name`
  177. 1. `group_name`
  178. 1. `opening_balance` (number) [**negative** = Debit / **positive** = Credit]
  179. 1. `net_debit`
  180. 1. `net_credit`
  181. 1. `closing_balance` (number) [**negative** = Debit / **positive** = Credit]
  182. ### profit-loss
  183. Fetches profit and loss data for period.
  184. **Input**
  185. |Argument|Description|
  186. |--|--|
  187. |targetCompany (optional)|Company name (defaults to active company)|
  188. |fromDate|Date in YYYY-MM-DD|
  189. |toDate|Date in YYYY-MM-DD|
  190. **Output**
  191. JSON: `{ "tableID": "..." }` with columns:
  192. 1. `ledger_name`
  193. 1. `group_name`
  194. 1. `closing_balance` (number) [**negative** = Debit / **positive** = Credit]
  195. ### balance-sheet
  196. Fetches balance sheet data for period.
  197. **Input**
  198. |Argument|Description|
  199. |--|--|
  200. |targetCompany (optional)|Company name (defaults to active company)|
  201. |fromDate|Date in YYYY-MM-DD|
  202. |toDate|Date in YYYY-MM-DD|
  203. **Output**
  204. JSON: `{ "tableID": "..." }` with columns:
  205. 1. `ledger_name`
  206. 1. `group_name`
  207. 1. `closing_balance` (number) [**negative** = Debit / **positive** = Credit]
  208. ### stock-summary
  209. Fetches stock item summary for period.
  210. **Input**
  211. |Argument|Description|
  212. |--|--|
  213. |targetCompany (optional)|Company name (defaults to active company)|
  214. |fromDate|Date in YYYY-MM-DD|
  215. |toDate|Date in YYYY-MM-DD|
  216. |stockGroup (optional)|Filter by stock group name|
  217. **Output**
  218. JSON: `{ "tableID": "..." }` with columns:
  219. 1. `stock_item_name`
  220. 1. `stock_group_name`
  221. 1. `opening_quantity` (number)
  222. 1. `opening_value` (number) [**negative** = Debit / **positive** = Credit]
  223. 1. `inward_quantity` (number)
  224. 1. `inward_value` (number)
  225. 1. `outward_quantity` (number)
  226. 1. `outward_value` (number)
  227. 1. `closing_quantity` (number)
  228. 1. `closing_value` (number) [**negative** = Debit / **positive** = Credit]
  229. ### ledger-balance
  230. Returns ledger closing balance as on date.
  231. **Input**
  232. |Argument|Description|
  233. |--|--|
  234. |targetCompany (optional)|Company name (defaults to active company)|
  235. |ledgerName|Exact ledger name|
  236. |toDate|Date in YYYY-MM-DD|
  237. **Output**
  238. JSON: `{ "amount": number }` where negative = Debit and positive = Credit.
  239. ### stock-item-balance
  240. Returns stock item closing quantity as on date.
  241. **Input**
  242. |Argument|Description|
  243. |--|--|
  244. |targetCompany (optional)|Company name (defaults to active company)|
  245. |itemName|Exact stock item name|
  246. |toDate|Date in YYYY-MM-DD|
  247. **Output**
  248. JSON: `{ "quantity": number, "unit_of_measurement": string }` when found.
  249. ### bills-outstanding
  250. Fetches receivable/payable bill-wise outstanding as on date.
  251. **Input**
  252. |Argument|Description|
  253. |--|--|
  254. |targetCompany (optional)|Company name (defaults to active company)|
  255. |nature|`receivable` or `payable`|
  256. |toDate|Date in YYYY-MM-DD|
  257. **Output**
  258. JSON: `{ "tableID": "..." }` with columns:
  259. 1. `bill_date`
  260. 1. `reference_number`
  261. 1. `outstanding_amount`
  262. 1. `party_name`
  263. 1. `overdue_days`
  264. ### ledger-account
  265. Fetches ledger account statement for period.
  266. **Input**
  267. |Argument|Description|
  268. |--|--|
  269. |targetCompany (optional)|Company name (defaults to active company)|
  270. |ledgerName|Ledger name|
  271. |fromDate|Date in YYYY-MM-DD|
  272. |toDate|Date in YYYY-MM-DD|
  273. **Output**
  274. JSON: `{ "tableID": "..." }` with columns:
  275. 1. `guid`
  276. 1. `date`
  277. 1. `voucher_type`
  278. 1. `voucher_number`
  279. 1. `alternate_ledger`
  280. 1. `party_name`
  281. 1. `amount` (number) [**negative** = Debit / **positive** = Credit]
  282. 1. `narration`
  283. ### stock-item-account
  284. Fetches stock item account statement for period.
  285. **Input**
  286. |Argument|Description|
  287. |--|--|
  288. |targetCompany (optional)|Company name (defaults to active company)|
  289. |itemName|Stock item name|
  290. |fromDate|Date in YYYY-MM-DD|
  291. |toDate|Date in YYYY-MM-DD|
  292. **Output**
  293. JSON: `{ "tableID": "..." }` with columns:
  294. 1. `date`
  295. 1. `voucher_type`
  296. 1. `voucher_number`
  297. 1. `party_ledger`
  298. 1. `quantity`
  299. 1. `amount` (number) [**negative** = Debit / **positive** = Credit]
  300. 1. `narration`
  301. 1. `tracking_number`
  302. 1. `voucher_category`
  303. ### ledger-create-update
  304. Creates or updates one or more ledger.
  305. **Note: This tool has ability to modify existing ledger. Always backup your Company before instructing this tool.**
  306. **Input**
  307. |Argument|Description|
  308. |--|--|
  309. |targetCompany (optional)|Company name (defaults to active company)|
  310. |masters|Array of ledger master objects to create/update|
  311. Master ledger object accepts following
  312. |Property|Description|
  313. |--|--|
  314. |name|Ledger name or New Ledger name (during update)|
  315. |_name|Existing ledger name|
  316. |parent|Group under which ledger would exists|
  317. |openingBalance|(optional) Opening Balance of the Ledger|
  318. |isBillWise|(optional) flag to set Bill-by-Bill referencing|
  319. |billCreditPeriod|(optional) Credit Period for bill in days|
  320. |mailingDetails|(optional) Business Name for mailing purpose, country, state, pincode, address|
  321. |gstRegistrationDetails|(optional) GST registration details like GST Number, Registration Type, Place of Supply (state)|
  322. **Output**
  323. JSON result returned by import operation (success/failure details).
  324. ### delete-master
  325. Delete one (or more) masters from Tally
  326. **Input**
  327. |Argument|Description|
  328. |--|--|
  329. |targetCompany (optional)|Company name (defaults to active company)|
  330. |collection|Type of master or collection to delete. One of: `group`, `ledger`, `vouchertype`, `unit`, `godown`, `stockgroup`, `stockitem`, `costcategory`, `costcentre`, `attendancetype`, `company`, `currency`, `gstin`, `gstclassification` |
  331. |name|array of name(s) of master to be deleted|
  332. **Output**
  333. JSON result returned by delete operation (count of deleted, skipped, etc).
  334. ### voucher-journal
  335. Creates one (or more) Journal vouchers in Tally.
  336. **Input**
  337. |Argument|Description|
  338. |--|--|
  339. |targetCompany (optional)|Company name (defaults to active company)|
  340. |vouchers|Array of journal voucher objects to create|
  341. Voucher object accepts following
  342. |Property|Description|
  343. |--|--|
  344. |isoptional|(optional) Set to `true` to create Optional voucher|
  345. |date|Voucher date in YYYY-MM-DD|
  346. |voucherType|(optional) Voucher type (defaults to `Journal` and must belong to Journal parent)|
  347. |voucherNumber|(optional) Voucher number|
  348. |narration|(optional) Narration text|
  349. |accountingEntry|Array of accounting lines (minimum 2 lines and sum of amount must be zero)|
  350. Accounting entry object accepts following
  351. |Property|Description|
  352. |--|--|
  353. |ledgerName|Ledger name|
  354. |amount|Amount for the line (**positive** = Credit / **negative** = Debit)|
  355. **Output**
  356. JSON result returned by import operation (success/failure details).
  357. ### set-company
  358. Sets active company context in Tally Prime.
  359. **Input**
  360. |Argument|Description|
  361. |--|--|
  362. |companyName|Company name to activate|
  363. **Output**
  364. JSON string: `"OK"` on success.
  365. ### set-period
  366. Sets active reporting period context in Tally Prime.
  367. **Input**
  368. |Argument|Description|
  369. |--|--|
  370. |fromDate|Start date in YYYY-MM-DD|
  371. |toDate|End date in YYYY-MM-DD|
  372. **Output**
  373. JSON string: `"OK"` on success.
  374. ## Environment Variables
  375. End-users are free to hard-code few settings which needs to be applied
  376. |Variable|Description|
  377. |--|--|
  378. |TALLY_PORT|Port Number of XML Server of Tally (*optional*, default is **9000**)|
  379. |TALLY_HOST|Host name or IP where XML Server is running (*optional*, default is **localhost**)|
  380. |BLOCK_WRITE|Controls if MCP completely block access of write functionality. Setting this flag to value **1** will completely hide write functionality tools from the tool list. [ **0 = Allow , 1 = Block** ] (optional, default is **0** i.e. allowed). Not applicable for Claude Desktop (as it offers graphical switch to disable write functionality)|
  381. |PORT|Tally MCP Server port number. Applicable only if Tally Prime MCP Server is deployed as Remote MCP server (*optional*, default is **3000**). Not applicable for Claude Desktop|
  382. |MCP_DOMAIN|Domain name of Tally MCP Server website (*optional*, default is https://localhost:9000). Not applicable for Claude Desktop|
  383. |PASSWORD|Password for the OAuth Login front-end page to authenticate genuine user (kindly set this to some complex password default is **password**). Not applicable for Claude Desktop|

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.