Mcp-firefly-iii MCP Server

A Model Context Protocol server that gives an AI assistant access to your own Firefly III instance — 152 operations behind 5 scoped tools, with reading, writing and deleting kept as three separate…

Local serverstdioMIT

What is the Mcp-firefly-iii MCP Server?

mcp-firefly-iii is an MCP project maintained in the yakupemreyerli/mcp-firefly-iii repository. The maintainer describes its purpose as “A Model Context Protocol server that gives an AI assistant access to your own Firefly III instance — 152 operations behind 5 scoped tools, with…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @yakupemreyerli/firefly-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares FIREFLY_API_URL, FIREFLY_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
firefly_query	Read anything. Its description carries the catalogue, so choosing an operation costs no extra call.
firefly_mutate	Create or change a record.
firefly_destructive	Delete a record, or rewrite one field across many records at once.
firefly_list_operations	What can I do with this entity?
firefly_get_schema	What parameters does this operation take?

How to install the Mcp-firefly-iii MCP Server

{
  "mcpServers": {
    "firefly": {
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/firefly-mcp"
      ],
      "env": {
        "FIREFLY_API_URL": "your-firefly.example",
        "FIREFLY_API_TOKEN": "YOUR_FIREFLY_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.