Skip to main content
Glama
bruchris

Folio MCP

by bruchris

Folio MCP

Open-source TypeScript client, Model Context Protocol server and CLI for Folio. Unofficial; not affiliated with Folio AS.

Accounts, transactions, events, receipt bytes, categories and payment drafts.

Package and release status

@bruchris/folio-mcp version 0.1.0 is prepared but not yet published to npm. Requires Node 22.14+; Node 24 is recommended. The following installation command applies after the first npm release.

npx -y @bruchris/folio-mcp

Set FOLIO_API_KEY in your client environment. Import the typed client from @bruchris/folio-mcp/client without launching MCP or loading environment files. Third-party Folio OAuth requires a vendor integration partnership. API keys remain supported for owner integrations.

Related MCP server: Firefly III MCP Server

Approval

MCP writes return a preview until confirm=true; the client must obtain approval before confirming. CLI writes require --confirm. Folio API payments remain drafts for approval in Folio. The model reads receipts; the adapter does not parse merchant layouts or guess VAT.

Development

npm ci
npm test
npm run typecheck
npm run build
npm run test:tooling
npm run check:public
npm run check:secrets

This repository contains only the Folio package in packages/folio-mcp and its supporting tooling. Its root workspace is private to prevent accidental publication of the tooling. The Freddy application source remains private and is excluded.

Package documentation · Public docs · Hosting · Contributing · Releases · Security

MIT license.

Related MCP Connectors

Related MCP Servers

  • F
    license
    B
    quality
    Not graded
    maintenance
    Provides access to YNAB (You Need A Budget) functionality through the Model Context Protocol, allowing users to view account balances, access transaction data, and create new transactions.
    10
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to manage Firefly III personal finance accounts and transactions through the Model Context Protocol.
    21 npm
    85
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    Provides programmable access to Ghostfolio portfolio management and financial data, enabling querying, analysis, and management of investment portfolios through a Model Context Protocol server.
    38
    45 PyPI
    20
    AGPL 3.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to interact with a Firefly III personal finance instance, programmatically managing accounts, transactions, and related financial operations through the Model Context Protocol.
    21 npm
    MIT