MCP server for Beancount Fava
Project description
Beancount Fava MCP Server
An MCP server to interface with Beancount Fava.
Installation
uvx beancount-fava-mcp@latest --fava-url=https://your-fava-instance/ledger-name
This is a beancount MCP that relies on a fava instance to provide the data instead of reading the beancount files directly. So this is allowed to be installed on a completely different machine than where your beancount files are stored.
It allows for simple authentication, but it is optional. You can set the following environment variables:
FAVA_URL: The URL of your Fava instance (overrides the --fava-url argument)FAVA_USERNAME: The username to authenticate withFAVA_PASSWORD: The password to authenticate with
Features
- Get ledger data
- Get accounts
- Get currencies
- Get payees
- Get tags
- Get links
- Query journal
- Run BQL
Future Plans
- Support some kind of write access to the ledger so that you can add transactions easily via your mcp client. (add_transaction added but still WIP)
Usage
Can be used with Claude Desktop or other MCP clients.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file beancount_fava_mcp-0.0.4.tar.gz.
File metadata
- Download URL: beancount_fava_mcp-0.0.4.tar.gz
- Upload date:
- Size: 11.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
615cd3d8887d794ea7ff328fced1c9d685e8ec480979b6e66d4efcf08bec6878
|
|
| MD5 |
9c00ad12ae3d13a39176d6b28c378135
|
|
| BLAKE2b-256 |
4582df8e88f82cbe637423bfcd607fddf1f8dd659b3d734ca62049ee06baa2ac
|
File details
Details for the file beancount_fava_mcp-0.0.4-py3-none-any.whl.
File metadata
- Download URL: beancount_fava_mcp-0.0.4-py3-none-any.whl
- Upload date:
- Size: 9.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2c6ae5f20fb005d303777f9041fc317a77398e2bb909d251dfc5d690cd9ce4d9
|
|
| MD5 |
97d2fed7271fe966debfdf3d6b96ed97
|
|
| BLAKE2b-256 |
a00f6ffd7db8f05e1398800699339857751451963bb261ddcd29377348d327e8
|
