MCP.so
登录

Firefly III MCP Server

@etnperlong

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

etnperlong

关于 Firefly III MCP Server

MCP Server for Firefly III

#firefly-iii#finance#budget#book-keeping

Firefly III MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": [
        "@firefly-iii-mcp/local"
      ],
      "env": {
        "FIREFLY_III_BASE_URL": "<YOUR_FIREFLY_III_BASE_URL>",
        "FIREFLY_III_PAT": "<YOUR_FIREFLY_III_PAT>"
      }
    }
  }
}

Firefly III MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Firefly III MCP Server?

A Model Context Protocol (MCP) server for Firefly III, a free and open-source personal finance manager. It allows AI tools to programmatically manage Firefly III accounts and transactions, enabling the creation of AI assistants for personal finance and accounting.

How to use Firefly III MCP Server?

Obtain a Personal Access Token from your Firefly III instance and provide it together with your Firefly III URL to the server. You can run the server locally via npx @firefly-iii-mcp/local, as an Express HTTP server (@firefly-iii-mcp/server), deploy to Cloudflare Workers, or run from source. Configure credentials via environment variables, request headers, or query parameters, and optionally filter the available tools using presets or custom tags to reduce token usage.

Key features of Firefly III MCP Server

  • Interact with Firefly III instances via AI
  • Programmatically manage accounts and transactions
  • Extensible toolset for various financial operations
  • Support for both local and cloud deployment
  • Compatible with the Model Context Protocol standard
  • Tool filtering via presets or custom tags to reduce token usage

Use cases of Firefly III MCP Server

  • Automate personal finance management with an AI assistant
  • Create AI-powered accounting tools for Firefly III
  • Integrate Firefly III with MCP-compatible clients like Claude Desktop
  • Focus on specific areas such as budgeting, reporting, or administration via tool presets

常见问题

1

What are the prerequisites for using Firefly III MCP Server?

You need a running Firefly III instance. For Cloudflare Workers deployment, a Cloudflare account is also required.

2

How do I obtain a Personal Access Token for Firefly III?

Log in to your Firefly III instance, go to **Options > Profile > OAuth**, and create a new Personal Access Token. Copy the token immediately – it will not be shown again.

3

How do I configure authentication for the MCP server?

Authentication can be supplied via request headers (`X-Firefly-III-Url` and `Authorization`), query parameters (`baseUrl` and `pat`), or environment variables (`FIREFLY_III_BASE_URL` and `FIREFLY_III_PAT`). Headers are recommended for security.

4

Can I filter which tools the server exposes?

Yes. Use a preset (`default`, `full`, `basic`, `budget`, `reporting`, `admin`, `automation`) or specify exact tool tags (e.g., `accounts,transactions,categories`) via environment variables or command-line options.

5

What deployment options are available?

You can run the server locally via `npx`, as an Express-based HTTP server, deploy to Cloudflare Workers with a single click, or run from the source repository.

评论

其他 分类下的更多 MCP 服务器