Skip to content

firefly-iii-mcp

Firefly III MCP API + MCP Server + A2A Agent for the agent-utilities ecosystem — a typed, action-routed connector.

Official documentation

This site is the canonical reference for firefly-iii-mcp, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

firefly-iii-mcp wraps the target service with typed, deterministic MCP tools and an optional Pydantic-AI agent server.

The connector remains inactive when credentials are absent: configure FIREFLY_III_URL and FIREFLY_III_TOKEN at runtime to connect it to an instance. Endpoints, credentials, private trust, and finance records are never packaged values.

Explore the documentation

  • Installation — pip, source, extras, and container targets.
  • Configuration — AgentConfig, verified TLS, secrets, and privacy.
  • Deployment — run the MCP and agent servers with runtime-injected configuration.
  • Usage — the MCP tools, the Python client, and the CLI.
  • Backing Platform — connect an operator-managed Firefly III service.
  • Overview — the action-routed tool surface and architecture.
  • Concepts — the CONCEPT ID registry.