Skip to main content
Glama
AxLabs

Banana Accounting MCP Server

by AxLabs

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BANANA_BASE_URLNoBase URL of the Banana web server (no trailing slash).http://127.0.0.1:8081
BANANA_TIMEOUT_MSNoPer-request timeout in milliseconds.30000
BANANA_DEFAULT_DOCNoOptional default document name so tools can omit the doc argument.
BANANA_ACCESS_TOKENYesAccess token from httpconfig.ini. Sent as X-Banana-Access-Token.
BANANA_INSECURE_TLSNoSet to true to accept the self-signed certificate used by the macOS SSL server.false

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
banana_applicationA

Get information about the running Banana Accounting application (version, serial, OS, Qt version, channel). Optionally request a single value by name (e.g. "serial", "version", "name").

banana_application_versionA

Get the Banana Accounting application version string (e.g. "10.2.5.26020").

banana_list_documentsA

List the accounting documents currently open in Banana Accounting as a JSON array of file names (e.g. ["accounting.ac2"]). Start here to discover the doc value used by other tools. Returns an empty array if no file is open.

banana_document_requestsA

Return the HTML page listing all available HTTP requests/endpoints for a given document. Useful for discovering what data a specific accounting file exposes.

banana_table_namesA

List the names of all tables in a document as a JSON array (e.g. ["Accounts", "Transactions", "Budget", "FileInfo", ...]).

banana_tableA

Return the content of a table in a document. Defaults to JSON. Supports selecting a view, a subset of columns, and html/json output.

banana_table_rowcountB

Return the number of rows in a table as text.

banana_table_columnsA

Return the list of column XML names for a table as a JSON array.

banana_cellA

Return the value of a single cell, identified by table, row selector, and column XML name.

banana_rowlist_namesA

Return the names of the row lists present in a table as a JSON array (e.g. ["Data", "Examples", "Archives"]).

banana_rowlistA

Return the content of a named row list within a table. Defaults to JSON.

banana_rowlist_rowcountB

Return the number of rows in a named row list of a table as text.

banana_rowlist_cellA

Return the value of a single cell within a named row list, identified by table, row list, row selector, and column XML name.

banana_accountsA

Return the list of accounts as a JSON array of {id, descr} objects (e.g. [{"id":"1000","descr":"1000 Cash"}]).

banana_account_descriptionA

Return the description of an account or group. Use "Gr=" to target a group. Optionally return a specific column instead of the default Description.

banana_groupsA

Return the list of accounting groups as a JSON array of {id, descr} objects (e.g. [{"id":"100","descr":"100 Current Assets"}]).

banana_segmentsA

Return the list of segments as a JSON array of {id, descr} objects.

banana_vatcodesB

Return the list of VAT codes as a JSON array of {id, descr} objects (e.g. [{"id":"V80","descr":"V80 Sales and services 8.0%"}]).

banana_vat_descriptionA

Return the description of a VAT code. Optionally return a specific column instead of the default Description.

banana_balanceA

Return the current accounting balance figure for an account, group or balance class. Use _p1/_p2 doc suffixes for previous years. Supports period, frequency and filter.

banana_budgetA

Return the budget figure for an account, group or balance class. Supports period, frequency and filter.

banana_interestA

Return the calculated interest on an account/group/class. Positive rate calculates interest on debit amounts, negative on credit amounts.

banana_budget_interestC

Return the calculated interest on an account/group/class for budget transactions.

banana_projectionA

Return the projection figure for an account, group or balance class. Requires projectionstart. Supports period, frequency and filter.

banana_vat_balanceA

Return the current VAT balance figure for a VAT code or VAT group. Supports period, frequency and filter.

banana_vat_budgetB

Return the budget VAT figure for a VAT code or VAT group.

banana_vat_projectionC

Return the projection VAT figure for a VAT code or VAT group. Requires projectionstart.

banana_account_cardA

Return the account card (ledger of transactions) for an account. Defaults to JSON. Supports view, columns, navigation, period and filter.

banana_budget_cardB

Return the budget card (budget transactions) for an account. Defaults to JSON.

banana_projection_cardB

Return the projection card for an account. Requires projectionstart. Defaults to JSON.

banana_vat_cardA

Return the account card for a VAT code (or pipe-separated codes, e.g. "V0|V80"). Defaults to JSON.

banana_accounting_reportA

Return the accounting report (enhanced balance sheet / P&L) for a document. Defaults to JSON. Supports view, columns, navigation, period and subdivision.

banana_vat_reportC

Return the VAT report for a document. Defaults to JSON.

banana_journalA

Return the journal (all transactions in chronological/posting order) for a document. Defaults to JSON.

banana_start_periodA

Return the start date (YYYY-MM-DD) of the accounting or of a given period abbreviation.

banana_end_periodA

Return the end date (YYYY-MM-DD) of the accounting or of a given period abbreviation.

banana_info_tableB

Return the file info table for a document. Defaults to JSON.

banana_info_valueA

Return a single file-info value, addressed by section name and id name (e.g. section "AccountingDataBase", id "BasicCurrency").

banana_infosA

Return all file infos for a document as a JSON array of {section, id, value} objects.

banana_messagesA

Return the list of accounting validation/error messages as a JSON array. Set recheck=true to force a fresh 'Recheck accounting' before returning.

banana_messages_countA

Return the number of error messages in the accounting file as text. Set recheck=true to force a fresh 'Recheck accounting' first.

banana_appdata_getB

Return the stored web-app data for a given data id.

banana_appdata_putB

Save web-app data under a data id. The data is sent as the request body. Provide a JSON object/array (sent as JSON) or a raw string.

banana_appdata_deleteA

Delete the stored web-app data for a given data id.

banana_appdata_formA

Return the HTML form used to create, modify or delete app data (/v2/appdataform).

banana_settingsA

Return the Banana web server settings page (/v2/settings).

banana_helpA

Return the web server help page (/v2/help).

banana_fileA

Return a file stored in Banana's user data folder (/v2/files/{file_name}), e.g. "httpconfig.ini".

banana_run_scriptA

Execute a Banana JavaScript file on the server (/v2/script). The script path can be absolute or relative to the user's document directory. Optionally pass a document and input data to the script.

banana_www_appA

Return a built-in WWW app HTML page for a document (/v2/doc/{doc}/apps/{app_name}). Known apps: "charts", "dashboard".

banana_api_jsA

Return the bananaapiv2.js JavaScript file that defines an object-oriented interface to the web server for a given document.

banana_create_documentA

Create a NEW accounting file in Banana and show it, applying row changes table by table. This opens a new accounting window in Banana for the user to review; it does not modify an already-open file. Provide either accountingType (new file from scratch) or ac2_base64 + title (new file based on an existing .ac2 template).

banana_create_document_rawA

Escape hatch for the Send Data API: POST a raw request body to /v2/doc. The body must match Banana's expected shape: { fileType: {...}, data: }. Use banana_create_document for the common cases.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AxLabs/banana-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server