Skip to main content
Glama
ABRA Flexi MCP Server

ABRA Flexi MCP Server

by vvitovec

ABRA Flexi MCP Server

Local stdio MCP server for ABRA Flexi / FlexiBee accounting workflows. It is intended for agent clients such as Codex, Claude Desktop, or any MCP-compatible local runtime that can launch a Node process.

This is the standalone MCP project. The separate remote ChatGPT App project is here: vvitovec/abra-flexi-chatgpt-app.

What It Does

  • connects to ABRA Flexi over the official REST API

  • reads companies, evidence metadata, records, partners, products, balances, overdue items, and accounting summaries

  • prepares accountant-focused document drafts

  • supports guarded write flows with validation, dry-run style checks, confirmations, and an audit log

  • keeps Flexi credentials out of prompts and MCP tool arguments

Related MCP server: sevdesk-mcp

Safety Model

The server is configured through flexi.config.json profiles. Each profile controls:

  • Flexi base URL and company slug

  • test or production mode

  • default response format

  • which env vars contain credentials

  • read, dry-run, and write evidence allowlists

  • whether writes require confirmation

Writes are not free-form passthrough calls. Tool handlers build known payloads, validate them, enforce evidence permissions, and record request audit files under .flexi-harness/logs.

Setup

npm install
cp .env.example .env

Edit .env with a dedicated ABRA Flexi REST API user:

FLEXI_PROD_USERNAME=api-user
FLEXI_PROD_PASSWORD=replace-me

Then edit flexi.config.json:

{
  "defaultProfile": "prod",
  "profiles": {
    "prod": {
      "baseUrl": "https://example.flexibee.eu",
      "company": "example_company_s_r_o_",
      "usernameEnv": "FLEXI_PROD_USERNAME",
      "passwordEnv": "FLEXI_PROD_PASSWORD"
    }
  }
}

Run Locally

npm run dev

For a production-style build:

npm run build
npm start

Codex MCP Config

After building, add a server entry like this to your Codex config:

[mcp_servers.abra_flexi]
command = "node"
args = ["/absolute/path/to/abra-flexi-mcp-server/dist/index.js"]
enabled = true

The server loads .env and flexi.config.json from the project directory.

Main Tool Areas

  • company and evidence discovery

  • flexible read-only evidence queries

  • partner and product search

  • invoice, payable, receivable, bank, cash, and internal document workflows

  • overdue and saldo summaries

  • accountant-first draft creation and guarded posting

  • latest-error explanation from the local audit log

Verification

npm run check
npm test
npm run build

The tests use mocked HTTP servers and fixture-style responses. They do not need real ABRA Flexi credentials.

Available Tools

29 tools
create_document_draftCreate document draftC

Create a draft accounting document and return a short confirmation payload.

Inputs: kind (required), partner_id (required), note, items, +8 more.

flexi_check_connectionCheck Flexi connectionA

Verify auth and basic company access. Use before the first real workflow.

Inputs: company, profile.

flexi_describe_evidenceDescribe evidenceC

Show compact schema metadata for one evidence. Detail lists are opt-in.

Inputs: evidence (required), company, profile, field_limit, +2 more.

flexi_execute_writeExecute writeC

Execute a prepared write and return a short confirmation payload.

Inputs: payload (required), evidence (required), confirmation_id (required), company, +3 more.

flexi_explain_last_errorExplain last errorB

Summarize the latest failed request from the audit log.

Inputs: no named parameters.

flexi_get_record_detailGet record detailC

Fetch one record detail. Relations and child collections are opt-in.

Inputs: id (required), evidence (required), company, profile, +2 more.

flexi_get_record_summaryGet record summaryC

Fetch one record with a small business summary.

Inputs: id (required), evidence (required), company, profile.

flexi_list_evidenceList evidenceB

Browse evidence catalog with small summaries. Use before search or writes.

Inputs: limit, query, offset, company, +2 more.

flexi_list_profilesList Flexi profilesB

List configured profiles and their write mode.

Inputs: no named parameters.

flexi_prepare_writePrepare writeC

Create a short-lived confirmation token for a validated write.

Inputs: payload (required), evidence (required), company, profile, +4 more.

flexi_search_recordsSearch recordsD

Search one evidence and return short record summaries. Query or filter is required.

Inputs: no named parameters.

flexi_validate_importValidate importB

Run a dry-run import and return only compact validation feedback.

Inputs: payload (required), evidence (required), company, profile, +2 more.

get_accounting_overviewGet accounting overviewC

Return a compact dashboard for unpaid receivables and payables.

Inputs: date, company, profile, include_overdue.

get_document_detailGet document detailA

Fetch one accounting document detail. Extra sections are opt-in.

Inputs: id (required), kind (required), company, profile, +4 more.

get_document_summaryGet document summaryC

Fetch one accounting document with a small business summary.

Inputs: id (required), kind (required), company, profile.

get_partner_balance_summaryGet partner balance summaryC

Return compact saldo totals for one partner.

Inputs: partner_id (required), date, company, profile.

get_partner_detailGet partner detailC

Fetch one partner detail. Bank accounts and contacts are opt-in.

Inputs: id (required), company, profile, include_contacts, +1 more.

get_partner_summaryGet partner summaryC

Fetch one partner with a small business summary.

Inputs: id (required), company, profile.

get_product_summaryGet product summaryC

Fetch one product from the price list.

Inputs: id (required), company, profile.

post_documentPost documentC

Finalize a supported accounting document by locking it.

Inputs: id (required), kind (required), company, profile.

search_documentsSearch documentsC

Search accounting documents by business filters and return short summaries.

Inputs: kind (required), limit, query, due_to, +10 more.

search_overdue_itemsSearch overdue itemsC

List overdue receivables or payables with compact report summaries.

Inputs: date, limit, scope, offset, +3 more.

search_partnersSearch partnersC

Find customers or suppliers and return short partner summaries.

Inputs: query (required), role, limit, offset, +2 more.

search_productsSearch productsC

Find products from the price list and return short summaries.

Inputs: query (required), limit, offset, company, +2 more.

search_reference_valuesSearch reference valuesC

Search compact lookup values such as document types, payment methods, or centers.

Inputs: kind (required), limit, query, offset, +2 more.

search_unpaid_documentsSearch unpaid documentsC

Find unpaid or overdue receivables and payables with compact summaries.

Inputs: kind (required), limit, offset, company, +3 more.

update_document_headerUpdate document headerC

Update common header fields on one accounting document.

Inputs: id (required), kind (required), changes (required), company, +1 more.

update_document_itemsUpdate document itemsC

Replace all items on one accounting document.

Inputs: id (required), kind (required), items (required), company, +1 more.

validate_documentValidate documentB

Dry-run validate the latest stored draft snapshot for one document.

Inputs: kind (required), id, company, profile.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.3/5.0

    Scored across 29 tools

    Disambiguation3/5

    Many tools have distinct roles but there is overlap between flexi_get_record_detail and get_document_detail, and similar pairs. The descriptions help, but the prefix split adds ambiguity.

    Naming Consistency2/5

    Inconsistent use of 'flexi_' prefix on some tools while others use plain snake_case. Patterns like 'get_partner_summary' vs 'flexi_get_record_summary' break uniformity.

    Tool Count3/5

    29 tools is high but covers a broad domain. Each tool seems justified, but the count could be reduced by consolidating similar summary/detail pairs.

    Completeness3/5

    Document workflow is well-covered (create, update, validate, post) but missing delete/cancel. Partners and products only have read/search, lacking create/update/delete.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Provides a comprehensive MCP interface to the AbraFlexi ERP REST API, enabling management of invoices, contacts, products, bank transactions, and other evidence through natural language.
      68
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with the sevDesk accounting API for managing contacts, invoices, credit notes, orders, vouchers, transactions, and parts.
      24 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying products and stock, sales orders, contacts, invoices, payables/receivables, and creating contacts through the official ERP API.
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables MCP clients to read invoices, supplier invoices, vouchers, financial reports, and AR/AP ageing from a Swedish accounting system, with optional draft-only write tools for customers, offers, orders, and unsent invoice drafts after confirmation. It also exposes many other read endpoints through a safety allowlist.
      26
      1
      MIT