Independent by design · no pay-to-rank placements  · How we evaluate tools →
Anclum Submit
Y

YakupEmreYerli/mcp-firefly-iii

Independent directory — not the official site. Details below come from the project's public repository.

4 ★ measured · checked 2026-11-19

Before you install: no copy-paste command · license MIT

First step: nothing runnable here yet - start from the repository: https://github.com/YakupEmreYerli/mcp-firefly-iii

★ 4·updated 2026-11-16
View on GitHub ↗Direct link · no redirect page

We have neither an install command nor a public remote endpoint from this repository, so we do not print a config. A made-up one is worse than none. How each client wires MCP up →

Star count
4 ★ · YakupEmreYerli/mcp-firefly-iii · read from the GitHub search API · (checked 2026-11-19 20:00:48)
Source
collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history
first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
Score
score 300 · 4 ★ · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository YakupEmreYerli/mcp-firefly-iii;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.
README excerpt (English, untranslated) · Read the full README on GitHub →

# Firefly III MCP Server

Excerpted from the repository README (abridged)

A Model Context Protocol server that gives an AI assistant access to your own Firefly III instance — 152 operations behind 5 scoped tools, with reading, writing and deleting kept as three separate, explicitly-authorized surfaces instead of one tool that can do all three.
> Türkçe: README.tr.md
"What did I spend the most on last month?"
"Find uncategorised transactions from August and suggest categories."
"Show me subscriptions whose amount went up."
Everyone runs this against their own Firefly instance with their own token — there is no hosted backend or relay in between.
Listed in the official MCP Registry as io.github.YakupEmreYerli/mcp-firefly-iii, on Glama, and in Firefly III's own third-party apps documentation. Every release is built and published by CI from a tagged commit, with npm provenance attesting that the tarball came from this repository.
## Demo
https://github.com/user-attachments/assets/d308b2b5-18ef-4275-a4ed-ccdb7f04386f
40-second demo: month-end in Claude Code. It reads October, finds 35 uncategorised payments, proposes a plan, dry-runs every write, and only writes after you approve, then checks Firefly III again: 0 left. All financial data shown is fabricated.
## Features
5 meta-tools, not 152. firefly_query, firefly_mutate, firefly_destructive, plus firefly_list_operations and firefly_get_schema for discovery — a typed registry maps every Firefly endpoint onto these instead of flooding the model's tool list.
dry_run on every write, returning the exact request — resolved record IDs included — without sending it.
Bulk writes can't run blind. Filter-driven updates require max_matches and refuse an incomplete scan before the first write; multi-split transaction groups are rejected outright rather than risk folding their amounts together.
Read/write/destructive are separately scoped and enforced, not just annotated — over stdio by the Firefly token, over HTTP by OAuth scope or a static token.
Embedded OAuth 2.1 authorization server for Claude web, Claude mobile, and ChatGPT — no separate Keycloak or Authentik install.
Docker images for linux/amd64/linux/arm64, and a self-checking documentation pipeline that keeps the tool catalogue in sync with the code.
It tells you when it is out of date. Once a day it checks whether a newer version exists and, if so, says so once — a line on stderr, a sentence beside the next answer. MCP_UPDATE_CHECK=false turns it off.
## Prerequisites
A running Firefly III instance and a Personal Access Token (Firefly III → Options → Profile → OAuth → Create New Personal Access Token)
Node.js 20.6+, unless you're using Docker
## Usage
| Method | Transport | Best for |
| npx — stdio | stdio | Claude Code, Claude Desktop, Cursor — simplest setup |
| Static token | HTTP | n8n, automation, headless callers |
| OAuth | HTTP + OAuth | Claude web, Claude mobile, ChatGPT — can't hold a static token |
| Docker | HTTP | Self-hosted, either auth mode above |
### 1. stdio (Claude Code, Claude Desktop, Cursor)
One click: Claude Desktop — download firefly-mcp- .mcpb from the latest release and open it; Claude Desktop asks for your Firefly III URL and token and keeps the token in the system keychain. Cursor — the button installs the server with your-firefly.example and your-token as placeholders; replace them in Cursor's MCP settings. VS Code — the button asks for the URL and the token when the server first starts.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/en/s/yakupemreyerli-mcp-firefly-iii/)
Source
awesome · https://github.com/YakupEmreYerli/mcp-firefly-iii
Browse by field
MCP servers
Traction
4 ★
Listed by
3 independent sources
added
today

More MCP servers

All 6,555 →

Filed under

Every tag opens the full list for that filter. Counts are the live catalogue figures.

Browse all fields →

← Back to index