Firefly III MCP Server

Сервер MCP (Model Context Protocol), который предоставляет Claude полный доступ к вашему экземпляру личных финансов Firefly III. Общайтесь с Claude на естественном языке, чтобы записывать расходы, проверять баланс, управлять бюджетами и многое другое.

Возможности

• Транзакции: создание, просмотр, поиск, обновление и удаление транзакций (снятие средств, депозиты, переводы)

• Счета: управление активами, расходами, доходами, обязательствами и кассовыми счетами

• Категории: организация транзакций по категориям

• Бюджеты: создание и управление бюджетами с поддержкой автоматического бюджетирования

• Теги: маркировка транзакций гибкими тегами

Предварительные требования

• Node.js >= 18

• Запущенный экземпляр Firefly III

• Токен личного доступа (PAT) из вашего экземпляра Firefly III

Получение вашего PAT

1. Войдите в свой экземпляр Firefly III

2. Перейдите в Options → Profile → OAuth

3. В разделе Personal Access Tokens создайте новый токен

4. Скопируйте токен — он понадобится вам для настройки

Установка

Через 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 естественным образом:

Запись транзакций

"Я потратил $45.50 в Trader Joe's на продукты сегодня"

"Запиши депозит зарплаты в размере $2,500 от моего работодателя на мой расчетный счет"

"Переведи $500 с расчетного счета на сберегательный"

Запросы

"Покажи мне все мои транзакции за прошлую неделю"

"Сколько я потратил на рестораны в этом месяце?"

"Какой баланс моего расчетного счета?"

Управление финансами

"Создай ежемесячный бюджет на продукты в размере $600"

"Перечисли все мои категории расходов"

"Отметь мои последние 3 транзакции в ресторанах как 'деловые обеды'"

Доступные инструменты

Разработка

# Watch mode with auto-reload
npm run dev

# Build for production
npm run build

# Run the built server
npm start

Лицензия

MIT