What is the Firefly III MCP Server?

The Firefly III MCP Server is a Model Context Protocol (MCP) server that enables AI tools to interact with Firefly III, a free and open-source personal finance manager. It allows users to manage their Firefly III accounts and transactions programmatically using AI.

What is Model Context Protocol (MCP)?

MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It allows AI models to access and interact with external data sources and tools.

What are the prerequisites for using the Firefly III MCP Server?

To use the server, you need a running Firefly III instance and a Personal Access Token (PAT) from your Firefly III account. If deploying to Cloudflare, a Cloudflare account is also required.

How do I obtain a Firefly III Personal Access Token (PAT)?

Log in to your Firefly III instance, navigate to Options > Profile > OAuth, and create a new Personal Access Token. Copy the generated token immediately, as you won’t be able to see it again.

How do I configure the MCP Server?

You can configure the server by providing the Firefly III PAT and instance URL via request headers (recommended), query parameters (use with caution), or environment variables.

What are the different ways to run the MCP Server?

You can run the server locally, as an Express server, deploy it to Cloudflare Workers, or run it locally from source.

What is tool filtering, and why is it important?

Tool filtering allows you to restrict the tools exposed to the AI client, reducing token usage and focusing on specific functionalities. This is especially useful when working with LLMs that charge based on token consumption.

What are the available tool presets?

The available presets are default, full, basic, budget, reporting, admin, and automation. Each preset includes a specific set of tools tailored to different use cases.

Can I use custom tool tags instead of presets?

Yes, you can specify a comma-separated list of tool tags to enable, overriding the preset if both are set.

How do I deploy the MCP Server to Cloudflare Workers?

You can deploy the server to Cloudflare Workers using the provided “Deploy to Cloudflare” button. After deploying, configure the required environment variables in your Cloudflare Worker’s settings.