Release v0.4.0

What's Changed

Added

• feat: implement destination_id support and enforce schema (8fdcbf8)
• feat: add scripts for schema updates and linting (6697bae)
• feat: implement financial analysis tools and service (7ee1457)
• feat: implement budget creation tool and service (3e1bddd)
• feat: add auto-budget validation to CreateBudgetRequest (054ca91)

Fixed

• fix: add temp fix for availble_budgets (346ce63)

Other

• chore: update runtime image to Debian 13 (5ef85e1)
• Merge pull request #61 from RadCod3/chore/switch-to-debian13 (72161b2)
• fix(tests): update failing test_get_available_budget (86b321f)
• Merge pull request #63 from RadCod3/fix/43-get-available-budget (01e2a45)
• chore: refactor README.md for clarity (8ef1a66)
• Merge pull request #64 from RadCod3/chore/update-readme (30641a9)
• chore: update README.md for clarity and organization (8111428)
• Merge pull request #65 from RadCod3/chore/update-readme (a0484bc)
• chore: upgrade dependencies (e3562bf)
• chore: update project description in pyproject.toml (004085e)
• chore: update Firefly III API schema to v6.4.16 (3d64134)
• test: increase unit test coverage and refactor tests (d31be5d)
• chore: upgrade dependencies (d399a4f)
• test: improve robustness of test revenue account lookup (4bf5ba1)
• Merge pull request #67 from RadCod3/feat/62-add-destinationid (8bbc3bc)
• test: add integration tests for insight tools (e187356)
• chore: upgrade dependencies (00a9cd0)
• test: fix values in test snapshots (1d889b2)
• test: use flexible checks for account ids (09d9547)
• Merge pull request #69 from RadCod3/feat/68-add-insight-tools (eb2b12b)
• test: add integration tests and cleanup for budget creation (a27e56f)
• docs: update tool counts and add create_budget to docs (943d8bb)
• Merge pull request #70 from RadCod3/feat/40-add-budget-create (dfdc711)
• chore: bump version (eab0a27)
• chore: regen uv.lock after version bump (3c9340a)
• Merge pull request #71 from RadCod3/release/v0.4.0 (a88adfe)

Docker Images

Multi-platform Docker images are available on GitHub Container Registry:

# Pull specific version
docker pull ghcr.io/RadCod3/LamPyrid:0.4.0

# Pull latest
docker pull ghcr.io/RadCod3/LamPyrid:latest

Supported Platforms: linux/amd64, linux/arm64

Installation

Using Docker (Recommended)

docker run -p 3000:3000 \
  -e FIREFLY_BASE_URL=your-firefly-url \
  -e FIREFLY_TOKEN=your-token \
  ghcr.io/RadCod3/LamPyrid:0.4.0

Using Docker Compose

See the docker-compose.yml in the repository.

From Source

git clone https://github.com/RadCod3/LamPyrid.git
cd LamPyrid
git checkout v0.4.0
uv sync
uv run lampyrid

Documentation

See the README for detailed configuration and usage instructions.

Release v0.3.0

What's Changed

Added

• Add language specifier to codeblock (c9b78fb)
• Add Docker volume permissions guidance for OAuth storage (1cdee52)
• feat: add type to Account model (c813439)
• feat: add create_account and create_budget methods to FireflyClient (4f289a8)
• feat: Refactor tests to use FastMCP client with snapshot validation (81caf71)
• chore: Add 'ty' dev dependency (a8e70bc)

Fixed

• fix: add error handling and fix validation errors (7c7d79e)
• fix: require non-empty query in search_accounts (03349dd)
• fix: ensure 'latest' Docker tag points only to releases (c7cc991)
• fix: replace TransactionType enum with TransactionTypeProperty (869ca8a)
• fix: silence ruff errors about imports (0fb9a7a)

Changed

• Update README.md (cacdebb)

Other

• Merge pull request #38 from RadCod3/chore/update-readme (75fb3bb)
• Merge pull request #46 from RadCod3/fix/45-validation-error (e0aa888)
• chore:update LICENSE to AGPL (d61a500)
• Merge pull request #49 from RadCod3/chore/41-update-license (fc7f6fc)
• docs: update Docker tagging documentation (2935ff0)
• style: format GitHub Actions workflow files (205ec91)
• chore: upgrade codeql-action to v4 (aaddd1c)
• Merge pull request #50 from RadCod3/fix/42-docker-publish-workflow (74718c9)
• feat(docker): exclude dev dependencies from image (4b6157e)
• feat(docker): implement multi-stage build for smaller images (2614a62)
• feat(assets): bundle assets to project (8121f41)
• refactor(docker): optimize multi-stage build (a777bd7)
• feat(docker): switch to distroless base for smaller images (7c00597)
• Merge pull request #51 from RadCod3/feat/48-optimize-docker (08e4db3)
• feat(oauth): implement persistent storage for OAuth tokens with encryption (fe9ac26)
• chore: upgrade dependencies and regen uv.lock (f47132c)
• Merge pull request #52 from RadCod3/feat/47-persist-oauth-tokens (a23485a)
• Initial plan (220fcf4)
• Improve volume permissions documentation based on code review feedback (5b5ae7d)
• Merge pull request #55 from RadCod3/copilot/update-readme-docker-permissions (c3aedb1)
• chore: add isort rules to ruff linter (ba680af)
• chore: upgrade dependencies and regen uv.lock (574922b)
• Merge pull request #56 from RadCod3/fix/54-keyerror-txtools (3cd2a85)
• chore: bump dependencies (029ddd8)
• test: add test enviroment startup script and deps (6911369)
• test: add tests to cover basic scenarios (90bef54)
• ci: add integration test job using automated test env setup (d4f889a)
• test: refactor fixtures and improve test setup (0c2f28f)
• ci: add codecov token to ci workflow (1784961)
• chore: Consolidate pytest configuration in pyproject.toml (459c5c2)
• chore: Enhance test setup verification script (ef57ea6)
• Merge pull request #57 from RadCod3/feat/20-add-tests (4f60e0c)
• refactor(services): introduce service layer between tools and clients (2624010)
• style: Convert tabs to spaces and add module docstrings (18269cc)
• test: add transaction filtering, search, and update tests (5b4ae85)
• test: add unit tests to increase coverage (58a4ada)
• refactor(txs): enhance bulk operations with atomic mode (0a943cf)
• refactor(tests): remove unused test (144147a)
• refactor(client): add async context manager support to FireflyClient (dd7c06b)
• refactor(services): sanitize user inputs in transaction search queries (d8842f0)
• fix(tests): update parameter names in get_budget_spending test (ae1c57a)
• fix(tests): add correct type to search_transactions_request fixture (913be3e)
• refactor(models): update Transaction date field to use utc_now (0b707b1)
• Merge pull request #58 from RadCod3/chore/34-rafactor-service (f4b449d)
• docs(README): update services layer documentation and license information (da74510)
• docs(README): add reference to firefly iii (c7dffb5)
• Merge pull request #59 from RadCod3/chore/update-readme (b9b7914)
• chore(deps): update sse-starlette to version 3.2.0 (4a1a06a)
• chore: update project version to 0.3.0 (786fcfa)
• Merge pull request #60 from RadCod3/release/v0.3.0 (18b5d5d)

Docker Images

Multi-platform Docker images are available on GitHub Container Registry:

# Pull specific version
docker pull ghcr.io/RadCod3/LamPyrid:0.3.0

# Pull latest
docker pull ghcr.io/RadCod3/LamPyrid:latest

Supported Platforms: linux/amd64, linux/arm64

Installation

Using Docker (Recommended)

docker run -p 3000:3000 \
  -e FIREFLY_BASE_URL=your-firefly-url \
  -e FIREFLY_TOKEN=your-token \
  ghcr.io/RadCod3/LamPyrid:0.3.0

Using Docker Compose

See the docker-compose.yml in the repository.

From Source

git clone https://github.com/RadCod3/LamPyrid.git
cd LamPyrid
git checkout v0.3.0
uv sync
uv run lampyrid

Documentation

See the README for detailed configuration and usage instructions.

Release v0.2.0

What's Changed

Added

• Add account filtering to get transactions (d0ccf6a)
• Add tx type filtering to account txs (98c1094)
• Add icons from firefly (737a3fd)
• Add icon to mcp server (738ef2c)
• Add custom favicon route (d235bfc)
• Add missing function return type (5d0925e)
• Add lint dependency to build and docker jobs (c317b45)
• Add transport and improve logs (a4ab553)
• Add log level config (0c86e6d)
• Add value sanitization for search queries (945089c)

Fixed

• Fix asset path resolution and Docker build (0737c57)
• Fix docker build workflow fail (4cf1230)
• Fix budgeted calculation initialization to handle None values (0e6a3c5)
• Fix account_id type to string for consistency (edf63e0)

Changed

• Update docker compose file (d3c0607)
• Refactor mcp tools to use composition (10633bc)
• Update uv.lock (07446f5)
• Update Dockerfile (24bac7c)
• Update firefly api spec to latest (57ffb6b)
• Refactor budget spending calculation (e8a3d1a)

Other

• Remove duplicate workflow runs (12921ff)
• Merge pull request #22 from RadCod3/fix-workflows (3916193)
• Improve field description (693d1f0)
• Merge pull request #21 from RadCod3/feat/#17 (ce2e239)
• Merge pull request #23 from RadCod3/feat/#18 (215b119)
• Remove unused imports (2be2bc8)
• Bump fastmcp version (0c2e433)
• Merge pull request #25 from RadCod3/feat/15-mcp-composition (2d5ce81)
• Bump python version (f22637e)
• Remove unused type ignore (e212934)
• Switch uv image to python3.14-alpine (6177ab8)
• Merge pull request #28 from RadCod3/chore/27-bump-python (e108b67)
• Bump datamodel-code-generator and Ruff (cf3bbf6)
• Bump uv.lock deps (afa392f)
• Merge pull request #30 from RadCod3/chore/bump-deps (9901163)
• Test lampyrid startup in CI (daaf8ee)
• Rename Docker image build step (d149442)
• Improve container startup and cleanup (6386f28)
• Improve server startup handling (a266197)
• Merge pull request #31 from RadCod3/feat/24-improve-ci (0495323)
• Merge pull request #33 from RadCod3/feat/32-log-config (283dbbb)
• Regen pydantic models from api spec (a73a2f9)
• Remove debug print (80b2f2b)
• Merge pull request #35 from RadCod3/fix/19-budget-tools (98d7a3d)
• Enhance transaction search functionality (131a9cb)
• Improve tx search criteria validation (1541fed)
• Merge pull request #36 from RadCod3/feat/29-improve-transaction-search (63f4303)
• Bump version to 0.2.0 in pyproject.toml (d7bd589)
• Regen uv.lock (b73eb13)
• Merge pull request #37 from RadCod3/release/v0.2.0 (e7055d6)

Docker Images

Multi-platform Docker images are available on GitHub Container Registry:

# Pull specific version
docker pull ghcr.io/RadCod3/LamPyrid:0.2.0

# Pull latest
docker pull ghcr.io/RadCod3/LamPyrid:latest

Supported Platforms: linux/amd64, linux/arm64

Installation

Using Docker (Recommended)

docker run -p 3000:3000 \
  -e FIREFLY_BASE_URL=your-firefly-url \
  -e FIREFLY_TOKEN=your-token \
  ghcr.io/RadCod3/LamPyrid:0.2.0

Using Docker Compose

See the docker-compose.yml in the repository.

From Source

git clone https://github.com/RadCod3/LamPyrid.git
cd LamPyrid
git checkout v0.2.0
uv sync
uv run lampyrid

Documentation

See the README for detailed configuration and usage instructions.

Release v0.1.0

What's Changed

Initial release of LamPyrid - A comprehensive MCP server for Firefly III personal finance management.

Features

• Fix trivy scan image name (7c68cd2)
• Fix Trivy scan to use single image reference (aa27c56)
• Add release workflows (f9b7b00)
• Refactor docker-compose file (7476b9e)
• Remove type ignore comments (d576c6b)
• Remove test dependencies (36fbfb4)
• Consolidate enviroment variables (6196e69)
• Remove tests as they are not used (c9d1811)
• Refactor tools for code clarity (0d60768)
• Disable tests till better testing (3054add)
• Remove legacy googleprovider (8e7dd3e)
• Enable debug logs (eba4d56)
• Merge pull request #16 from RadCod3/auth-support (3900c44)
• Use fastmcp GoogleProvider (d28c34a)
• Add new firefly openapi spec (0873cc2)
• Bump dep versions (18385cb)
• Merge pull request #14 from RadCod3/auth-support (60fb227)
• Merge branch 'docker-support' into auth-support (3d56905)
• Add sse transport support (a960077)
• Use streamable http for client transport (12f0fc9)
• Fix github action bug (a60bef8)
• Add initial docker support (029f397)
• Add google oidc auth (5857a78)
• Merge pull request #11 from RadCod3/chore/update-descriptions (e383ac2)
• Add better descriptions to tools and fields (f620095)
• Merge pull request #10 from RadCod3/feat/bulk-updates (e0d6952)
• Add copilot suggestions (5b5f57d)
• Add bulk transaction update tool (8e0d660)
• Add update transcation tool (305ba79)
• Add bulk transaction creation tool (705be6d)
• Merge pull request #8 from RadCod3/fix/budget-validation-bug (cd6a4b5)
• Fix get_available_budget validation bug (c0b66b9)
• Merge pull request #7 from RadCod3/add-readme (7508146)
• Address comments (0f0d5ec)
• Mention license (895acf9)
• Fix directory tree structure with ASCII characters (44d2429)
• Add README.md (ef39e97)
• Merge pull request #5 from RadCod3/budget-support (7c39d71)
• Add comprehensive budget analysis tools (52a542d)
• Add proper validation to budget model (390e867)
• Add budget support for transactions (99980c4)
• Add transaction and account management tools (d4a7e29)
• Add tests (78d5caf)
• Add transaction retrieval and search (a5f8943)
• Support adding transfers (9c8e85b)
• Support adding withdrawals and deposits (927dc3f)
• Use ruff formater (332fbfd)
• Hide unnecessary information from mcp host (73ffe73)
• Implement list accounts (df59c78)
• Initial commit (6528306)## Docker Images

Multi-platform Docker images are available on GitHub Container Registry:

# Pull specific version
docker pull ghcr.io/RadCod3/LamPyrid:0.1.0

# Pull latest
docker pull ghcr.io/RadCod3/LamPyrid:latest

Supported Platforms: linux/amd64, linux/arm64

Installation

Using Docker (Recommended)

docker run -p 3000:3000 \
  -e FIREFLY_BASE_URL=your-firefly-url \
  -e FIREFLY_TOKEN=your-token \
  ghcr.io/RadCod3/LamPyrid:0.1.0

Using Docker Compose

See the docker-compose.yml in the repository.

From Source

git clone https://github.com/RadCod3/LamPyrid.git
cd LamPyrid
git checkout v0.1.0
uv sync
uv run lampyrid

Documentation

See the README for detailed configuration and usage instructions.