Skip to main content
Glama
UrielX16-git

Firefly III MCP Server

by UrielX16-git

Firefly III MCP Server

Servidor MCP para integrar la API de Firefly III con agentes de IA y flujos de automatización. Implementado usando el SDK oficial @modelcontextprotocol/server (v2) con transporte Streamable HTTP (stateless).

Características

  • 🚀 SDK v2 de Model Context Protocol (Stateless, Web-standard)

  • 🔌 Transporte HTTP Streamable

  • 🛡️ Autenticación mediante MCP_API_KEY (Bearer Token)

  • 📊 Paginación, limitación de tamaño y formato dual (JSON / Markdown)

  • 🐳 Despliegue en contenedor Docker

Related MCP server: Firefly III MCP Server

Requisitos Previos

  • Contenedor de Firefly III corriendo en Docker.

  • Personal Access Token de Firefly III (En tu perfil de Firefly > OAuth > Personal Access Tokens).

Configuración y Despliegue (Local / Producción)

  1. Configurar el entorno Copia el archivo de ejemplo para configurar tus claves:

    cp firefly-mcp/.env.example firefly-mcp/.env

    Abre .env y edita:

    • FIREFLY_PAT: Tu Personal Access Token.

    • MCP_API_KEY: Genera una clave segura.

  2. Arrancar el entorno Agregar al docker-compose de firefly-iii

    docker compose up -d

Related MCP Connectors

  • Personal finance for AI agents: accounts, budgets, goals, 9-strategy debt payoff, reports. OAuth 2.1

  • Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.

  • Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client. Air Pipe MCP token as a bearer credential, e.g. 'Authorization: Bearer <token>'. Create one at https://app.airpipe.io/

  • Personal finance for AI agents: budgets, receipts, net worth, spend checks. Read-only OAuth.

Related MCP Servers

  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI tools to interact with Firefly III personal finance management instances through a cloud-deployed MCP server. Supports financial operations like account management, transactions, budgeting, and reporting with configurable tool presets.
    11 npm
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables interaction with Firefly III personal finance management instances via the Firefly III API, deployed as a Cloudflare Worker. It allows AI tools to manage transactions, accounts, budgets, and reporting through natural language.
    11 npm
    ISC
  • A
    license
    C
    quality
    D
    maintenance
    Provides comprehensive AI-agnostic access to all Firefly III personal finance features via 66 tools, enabling natural language management of accounts, transactions, budgets, and more.
    66
    7 npm
    23
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to manage personal finances through Firefly III, supporting tasks like recording transactions, managing budgets, and generating financial summaries.
    3 npm
    MIT