you-need-an-mcp
An MCP server providing LLMs access to a YNAB budget.
Setup
1. Install Dependencies
uv sync
2. Get YNAB Access Token
To use this MCP server, you need a YNAB Personal Access Token:
- Log into your YNAB account at https://app.youneedabudget.com
- Go to Account Settings (click your email in the top right corner)
- Click on Developer Settings in the left sidebar
- Click New Token
- Enter a token name (e.g., "MCP Server")
- Click Generate
- Copy the generated token (you won't be able to see it again)
3. Set Environment Variables
export YNAB_ACCESS_TOKEN=your_token_here
Optionally, set a default budget ID to avoid having to specify it in every call:
export YNAB_DEFAULT_BUDGET=your_budget_id_here
4. Run the Server
uv run python server.py
Available Tools
list_budgets()- Returns all your YNAB budgetslist_accounts(budget_id=None, limit=100, offset=0, include_closed=False)- Returns accounts with pagination and filteringlist_categories(budget_id=None, limit=50, offset=0, include_hidden=False)- Returns categories with pagination and filteringlist_category_groups(budget_id=None)- Returns category groups with totals (lighter weight overview)
Pagination
The list_accounts and list_categories tools support pagination. Use the offset parameter to get subsequent pages:
- First page:
list_categories(limit=50, offset=0) - Second page:
list_categories(limit=50, offset=50) - Check
pagination.has_moreto see if there are more results
Security Note
Keep your YNAB access token secure and never commit it to version control. The token provides read access to all your budget data.
Metadata
Release files for iflow-mcp_you-need-an-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_you_need_an_mcp-0.1.0.tar.gz | 24.3 kB | Without provenance | Details for iflow_mcp_you_need_an_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_you_need_an_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_you_need_an_mcp-0.1.0-py3-none-any.whl |
Total release size: 26.6 kB
Release files / iflow_mcp_you_need_an_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_you_need_an_mcp-0.1.0.tar.gz |
|---|---|
| Size | 24.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c69f4451195184b3ef7d94338fb248a602e9797214fcac570d31590493a3fd64
|
|
BLAKE2b-256 checksum How to use checksums |
dcc6954c9da229a10e3e404c0b567f8c76e087f5817fa00d01bc3170712a088f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_you_need_an_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_you_need_an_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 2.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64305ce95b8037090c4bafc837410541dc9a1d9a5b3abc01ed4485f8ddba7a32
|
|
BLAKE2b-256 checksum How to use checksums |
ba03bba06f8f9054255d60f8c9fe26088b1f31b7270118ddda27f3ea592536b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_you-need-an-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.