cameri/ynab-mcp-python
If you are the rightful owner of ynab-mcp-python and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
YNAB MCP Server to use YNAB's API
YNAB MCP Server
A Python-based MCP (Machine-readable Co-operation Plan) Server for interfacing with the YNAB (You Need A Budget) API.
About The Project
This project provides a server that acts as a bridge between a client application and the YNAB API. It is designed to work with both stdio and HTTP transports, making it flexible for various client implementations. The core idea is to provide use-case-driven tools rather than a direct 1-to-1 mapping of YNAB API endpoints.
We follow a spec-driven development approach. You can find our documentation in the docs/ directory.
Getting Started
To get a local copy up and running, follow these simple steps.
Prerequisites
- Python 3.12+
- Poetry
- pyenv (recommended for managing Python versions)
Installation
-
Clone the repo
git clone https://github.com/cameri/ynab-mcp-python.git cd ynab-mcp-python -
Set up the Python version
pyenv install 3.12 pyenv local 3.12 -
Install dependencies
poetry install -
Install pre-commit hooks
poetry run pre-commit install
Usage
The server can be started with either stdio or http transport.
poetry run python src/ynab_mcp_server/main.py --transport stdio
or
poetry run python src/ynab_mcp_server/main.py --transport http
(Note: The implementation of the server is not yet complete.)
Contributing
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
Please read our for details on our code of conduct, and the process for submitting pull requests to us.
License
Distributed under the MIT License. See LICENSE for more information.