Money Manager MCP Server
An MCP (Model Context Protocol) server that enables AI assistants to manage personal finances through the Realbyte Money Manager application.
✨ Features
18 MCP Tools for comprehensive financial management
Transaction Management - Create, read, update, delete transactions
Asset Tracking - Manage bank accounts and investments
Credit Card Support - Track cards and balances
Financial Reports - Summaries, trends, and Excel exports
Dashboard Analytics - Portfolio breakdowns and trends
Session Persistence - Maintains login across restarts
🚀 Quick Start
1. Prerequisites 🛠️
Ensure you have the following before starting the installation:
Node.js (version 18 or higher): Required for running the server
Money Manager App Web Server Enabled: The web server must be running on your phone (How to enable)
Same Network: Your computer and your phone must be connected to the same Wi-Fi network.
2. Integration for IDEs & AI Clients 💻
A. VS Code / GitHub Copilot
One Click Installer:
Use the oneclick installer below for the fastest setup. This will create the necessary configuration file and prompt you for the base URL.
Manual Configuration:
If the buttons fail, add the following JSON block to your workspace's .vscode/mcp.json or root mcp.json file:
B. Claude Desktop
Add the server definition to your claude_desktop_config.json:
Config file location:
macOS/Linux:
~/.config/claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
3. Enabling the Money Manager Web Server 📱
You must start the web server in the app to get the necessary IP address and port for the $\text{npx}$ command.
Open the Money Manager app on your phone.
Navigate to More (three dots icon).
Select PC Manager.
Tap Start to launch the web server.
Note the displayed IP address and Port (e.g.,
192.168.1.1:8888). Use this entire string as thehttp://YOUR_PHONE_IP:PORTvalue in your commands.
📖 For advanced setup options, see docs/SETUP.md
📋 Available Tools
Category | Tools | Description |
Initialization |
| Get categories, payment types, configuration |
Transactions |
,
,
,
| Full CRUD for income/expenses |
Summaries |
,
| Financial reports and exports |
Assets |
,
,
,
| Bank account management |
Credit Cards |
,
,
| Credit card tracking |
Transfers |
,
| Move money between accounts |
Dashboard |
,
| Analytics and trends |
📖 For usage examples, see docs/USAGE.md
📚 Documentation
Document | Description |
Installation and configuration | |
Tool descriptions and examples | |
Technical API reference | |
System design and structure | |
How to contribute |
⚠️ Legal Disclaimer
IMPORTANT: Please read before using this software.
Money Manager is a personal finance application developed by RealByte
This MCP server is an independent community project
This project is NOT affiliated with, endorsed by, or sponsored by RealByte
Use of this software is at your own risk
This project is intended for personal and educational use only
Users are responsible for ensuring compliance with Money Manager's terms of service
The maintainers of this project assume no liability for any issues arising from its use
By using this software, you acknowledge that you understand and agree to these terms.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🤝 Contributing
Contributions are welcome! Please see our Contributing Guide for details.
Fork the repository
Create a feature branch
Make your changes
Submit a pull request
🙏 Acknowledgments
Model Context Protocol for the MCP specification
The open-source community for inspiration and support