Ledger Mate MCP Server For Typescript

🚀 AI Ledger

AI Ledger is a personal intelligent accounting tool powered by artificial intelligence, enabling "instantaneous accounting and account query with a single sentence" through natural language interaction. You simply need to input something like "Breakfast cost 25 yuan, paid via Alipay" or "Salary of 18,000 yuan has been credited to the bank card", and the system will automatically parse the amount, category, and payment method and record them in the ledger. Moreover, it supports the use of the 🔥MCP client.

✨ Features

• Instantaneous Accounting: Achieve "instantaneous accounting" through natural language interaction.
• Multiple Modes: Besides text, it also supports accounting by translating images, voices, and files into natural language (requires the support of the MCP Client).
• Intelligent Categorization: AI automatically recognizes natural language for accurate categorization. The categorization scope is limited to the categories you configure yourself.
• Multi - platform Support: Supports WeChat Mini - programs and MCP clients.

🎥 Video Demonstrations

【Accounting with natural language】
https://www.bilibili.com/video/BV1TsdLYMEEb/

【Accounting with an Alipay bill screenshot】
https://www.bilibili.com/video/BV16VoEYKEGe/

📱 Applications that can directly use AI Ledger

• Claude for Desktop
• Cursor
• Trae
• VS Code
• Cherry Studio
• Cline

🎉 Configuration in any MCP - supported application:

Open the application, find the MCP Server configuration, and then add the following configuration as prompted by the application.

{
  "mcpServers": {
    "ledger-mate-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@big_mouth_cn/ledger-mate-mcp-server"
      ],
      "env": {
        "LEDGER_MATE_ACCESS_KEY": "<YOUR_ACCESS_KEY>"
      }
    }
  }
}

💻 Usage Example in Claude

1. Prerequisites

1. You need to prepare an MCP - supported client, such as Claude for Desktop.
2. Open the WeChat Mini - program "Aixiaoji" for registration and login.

2. Installation and Configuration

• Install and launch the AI Ledger tool in Claude.
• Complete the MCP Server configuration as prompted and ensure that the environment variables are set correctly:

LEDGER_MATE_ACCESS_KEY=<YOUR_ACCESS_KEY>

3. Usage Guide

• Accounting: Conduct accounting by inputting natural language or using multi - mode data (images, voices, files).
  • Examples:
    • Help me record that I spent 20 yuan on a taxi ride via Alipay, 18.5 yuan on breakfast, and 53 yuan on fruits, paid via WeChat.
    • Record that I received a salary of 12,000 yuan yesterday and deposited it into the bank card.
• Query: Use natural language to query accounts.
  • Examples:
    • Query the summary of income and expenses this month.
    • View the top five expense items this month.

4. Function Demonstration

• Demonstration video links: Accounting with natural language and Accounting with an Alipay screenshot

❓ Frequently Asked Questions

⚠️ Important Note

• Are there other ways to view and manage my ledger besides using the MCP client?
  Currently, you can view and manage it through the WeChat Mini - program "Aixiaoji", which provides traditional operation methods. The mini - program will also support interaction in natural language, voice, etc. More features are under development 🚧.
• Which MCP clients are supported?
  In addition to Claude, it theoretically supports all MCP Clients as long as they can execute Node. A Python version will be available soon.