전문가 수준의 AI-agnostic Bridge는 Firefly III 개인 금융 인스턴스에 AI 보조를 연결하는 100 % API 범위를 제공합니다.

**66 도구 ** 모든 주요 Firefly III 기능 포함 : 계정, 거래, 예산, 청구서, 재발 규칙, 자동화, 통찰력, 첨부 파일, 통화 및 기타.

---

호환성

| AI Platform | 프로토콜 | 연결 | 설정 가이드 | | | | | | | | | | | | |Claude Code | MCP(Native) | 스트로디 | CLAUDE.md | |Claude 데스크톱 | MCP(Native) | 스트로디 | CLAUDE.md | |Gemini CLI | MCP Extension | 스트로디 | 젬니미 | 젬니 | 젬디 | 젬니 | 젬니 | 젬미 | 젬니 | 젬니 | 젬디 | 젬니 | 젬디 | 젬니 | 젬니 | 젬니 | 젬디 | 젬니 | 젬니 | 젬디 | 젬니 | 젬디 | |Cursor / VS Code | MCP | 스트로디 또는 SSE | 수동 설정은 아래의 | |ChatGPT | OpenAPI 동작 | REST / JSON | [T0]] 엔드포인트 | |Custom Apps | REST API | HTTP | /api/ 엔드포인트 |

---

설치

# 필수품

• Node.js v18 이상
• Firefly III 인스턴스 실행
• A **개인 액세스 토큰 ** Firefly III에서 (프로필 → OAuth → 개인 액세스 토큰 → 새 토큰 생성)

# 클론 및 설치

---

플랫폼에 의해 설정

Claude 코드 (추천)

Claude Code는 MCP 서버 구성의 프로젝트 디렉토리에서 [T2]를 사용합니다.

Universal Firefly III AI Bridge (v3.0.0)

A professional-grade, AI-agnostic bridge providing exhaustive 100% API coverage for connecting AI assistants to your Firefly III personal finance instance.

66 tools covering every major Firefly III capability: accounts, transactions, budgets, bills, recurring rules, automation, insights, attachments, currencies, and more.

---

Compatibility

---

Installation

Prerequisites

• Node.js v18 or later
• A running Firefly III instance
• A Personal Access Token from Firefly III
  (Profile → OAuth → Personal Access Tokens → Create new token)

Clone and install

git clone https://github.com/fabianonetto/mcp-server-firefly-iii.git
cd mcp-server-firefly-iii
npm install

---

Setup by Platform

Claude Code (Recommended)

Claude Code uses .mcp.json in the project directory for MCP server configuration. Credentials go in a separate .env file so no secrets are ever in config files.

1. Create .env in the repo root (gitignored — never committed):

FIREFLY_URL=http://your-host:PORT
FIREFLY_TOKEN=your_personal_access_token

Get your token: Firefly III → Profile → OAuth → Personal Access Tokens → Create new token

2. Create .mcp.json in the repo root (gitignored — never committed):

{
  "mcpServers": {
    "firefly-iii": {
      "command": "node",
      "args": ["./index.js"]
    }
  }
}

The server reads credentials from .env automatically. No secrets in .mcp.json.

3. Start Claude Code from the repo directory:

claude

The server starts automatically. Claude Code will prompt you to approve it on first launch (once only).

4. Verify the connection by asking:

Use the get_about tool

You should receive your Firefly III version and API information.

Using from other projects:
Copy both .env and .mcp.json to any other project directory, changing ./index.js to the absolute path:

"args": ["/absolute/path/to/mcp-server-firefly-iii/index.js"]

See CLAUDE.md for the full guide including auto-approval configuration.

---

Claude Desktop

Add the server to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {