Firefly III MCP 서버

npm version License: MIT

Claude가 Firefly III 개인 재무 인스턴스에 완전히 액세스할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다. Claude와 자연어로 대화하여 지출을 기록하고, 잔액을 확인하고, 예산을 관리하는 등의 작업을 수행하세요.

기능

거래: 거래(출금, 입금, 이체) 생성, 목록 조회, 검색, 업데이트 및 삭제
계좌: 자산, 지출, 수익, 부채 및 현금 계좌 관리
카테고리: 카테고리로 거래 정리
예산: 자동 예산 지원을 포함한 예산 생성 및 관리
태그: 유연한 태그로 거래 라벨링

사전 요구 사항

Node.js >= 18
실행 중인 Firefly III 인스턴스
Firefly III 인스턴스의 개인 액세스 토큰(PAT)

PAT 발급 방법

Firefly III 인스턴스에 로그인합니다.
Options → Profile → OAuth로 이동합니다.
Personal Access Tokens에서 새 토큰을 생성합니다.
토큰을 복사하세요. 설정 시 필요합니다.

설치

npm을 통한 설치 (권장)

npm install -g firefly-iii-mcp-server

소스에서 설치

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

설정

Claude Desktop

Claude Desktop 설정 파일을 편집하세요:

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

npm으로 설치된 바이너리 사용:

{
  "mcpServers": {
    "firefly-iii": {
      "command": "firefly-iii-mcp-server",
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

또는 npx 사용 (전역 설치 불필요):

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Claude Code CLI

claude mcp add firefly-iii \
  -e FIREFLY_III_URL=https://your-firefly-instance.example.com \
  -e FIREFLY_III_PAT=your-personal-access-token-here \
  -- npx -y firefly-iii-mcp-server

또는 .claude/settings.json에 추가:

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

사용 예시

설정이 완료되면 Claude와 자연스럽게 대화하세요:

거래 기록

"오늘 Trader Joe's에서 식료품비로 $45.50을 썼어"

"고용주로부터 받은 $2,500 급여 입금을 내 당좌 예금 계좌에 기록해줘"

"당좌 예금에서 저축 계좌로 $500 이체해줘"

조회

"지난주 내 모든 거래 내역을 보여줘"

"이번 달에 식당에서 얼마를 썼지?"

"내 당좌 예금 계좌 잔액이 얼마야?"

재무 관리

"월 $600의 식료품 예산을 만들어줘"

"내 모든 지출 카테고리 목록을 보여줘"

"마지막 3개의 식당 거래에 'business meals' 태그를 달아줘"

사용 가능한 도구

도구	설명
`firefly_create_transaction`	출금, 입금 또는 이체 생성
`firefly_list_transactions`	필터를 사용하여 거래 목록 조회
`firefly_get_transaction`	ID로 거래 세부 정보 조회
`firefly_update_transaction`	기존 거래 업데이트
`firefly_delete_transaction`	거래 삭제
`firefly_search_transactions`	Firefly III 쿼리 구문으로 검색
`firefly_create_account`	새 계좌 생성
`firefly_list_accounts`	유형별 계좌 목록 조회
`firefly_get_account`	계좌 세부 정보 조회
`firefly_update_account`	계좌 속성 업데이트
`firefly_delete_account`	계좌 삭제
`firefly_list_categories`	모든 카테고리 목록 조회
`firefly_create_category`	카테고리 생성
`firefly_update_category`	카테고리 업데이트
`firefly_delete_category`	카테고리 삭제
`firefly_list_budgets`	모든 예산 목록 조회
`firefly_create_budget`	예산 생성
`firefly_update_budget`	예산 업데이트
`firefly_delete_budget`	예산 삭제
`firefly_list_tags`	모든 태그 목록 조회
`firefly_create_tag`	태그 생성
`firefly_update_tag`	태그 업데이트
`firefly_delete_tag`	태그 삭제

개발

# Watch mode with auto-reload
npm run dev

# Build for production
npm run build

# Run the built server
npm start

라이선스

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Firefly III MCP Server