Skip to main content
Glama
Sign In
Folio MCP

Folio MCP

by bruchris
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP YNAB Server

      Meh-S-Eze
      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
      -

    • Firefly III MCP Server

      etnperlong
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Firefly III personal finance accounts and transactions through the Model Context Protocol.
      25 npm
      91
      MIT

    • Ghostfolio MCP Server

      mhajder
      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.
      39
      1,215 PyPI
      22
      AGPL 3.0

    • Firefly III MCP Server

      IvanChurakov
      A
      license
      Not graded
      quality
      D
      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.
      25 npm
      MIT