Skip to main content
Glama
KikoBooks MCP Server

KikoBooks MCP Server

KikoBooks MCP Server

A Model Context Protocol (MCP) server for KikoBooks — enterprise AI-agentic bookkeeping software. This server enables AI assistants like Claude, GitHub Copilot, and OpenAI-powered agents to interact with your KikoBooks accounting data through natural language.

Building an agent on top of this server? Read SKILL.md — the operating guide (status-first connect, write-tier approval, read-back verification, never expose secrets).

Maintaining or extending it? See CONTRIBUTING.md for the facts that must stay accurate and the release steps.

Features

  • Chart of Accounts — Search, get, create, and update GL accounts

  • Customers — Full CRUD with soft delete for customer management

  • Invoices — Search, create, and manage AR invoices

  • Items — Manage products and services

  • Vendors — Full CRUD with soft delete for vendor management

  • Bills — Full CRUD with void for AP bills

  • Journal Entries — Search, create, post, and reverse GL journal entries

  • Bill Payments — Search, create, and void AP payments

  • Purchases / Expenses — Full CRUD with delete for expense transactions

  • Customer Payments — Search, create, and manage AR payments

  • Credit Memos — Search, create, and manage AR credit memos

  • Sales Receipts — Search, create, and manage sales receipts

  • CRM — Leads, deals, and pipeline (search/create/update), plus stage moves and customer promotion

  • Proposals — Search and copy proposals; convert accepted proposals to invoices or jobs

  • Workflow — Jobs (Projects/Engagements) and tasks; status updates and job-to-invoice billing

  • Lifecycle bridges — CRM deal → proposal → job → invoice, end to end

  • Reports — Trial balance, profit & loss, AR/AP aging, cash position, income/expense by category, business health (read-only)

  • Banking — Bank accounts, imported transactions, and reconciliation sessions, plus the reconciliation lifecycle (start, set statement balance, complete, cancel)

  • Deposits, Fixed Assets, Recurring Schedules, Statements — Search and get, plus deposit posting, fixed-asset depreciation and disposal, recurring-schedule controls, and statement sending

  • Connection & discovery — Connection status and per-org enabled-module discovery (no secrets exposed)

CRM, Proposals, and Workflow tools require the org to have the Sales / Workflow modules enabled (always on for accounting firms; opt-in for self-service businesses). Call get_enabled_modules first to check.

Related MCP server: Alegra MCP Server

Prerequisites

  • Node.js 18 or higher

  • A KikoBooks or Accountant.World organization (start free)

  • An org API key: sign in, open Settings → API Keys (direct link), create a key, and copy it once. Keys can be scoped, set to expire, and revoked at any time.

Supported clients

Any MCP client that can launch a local (stdio) server: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (GitHub Copilot), and others. ChatGPT connectors require a hosted (remote HTTPS) MCP endpoint, which KikoBooks does not offer yet.

Setup

Most users don't need this. To use the published server, skip to Configuration — the npx command pulls it from npm automatically. The steps below are for local development / contributing.

  1. Install dependencies:

npm install
  1. Create a .env file (copy from .env.example):

KIKOBOOKS_BASE_URL=https://ai.kikobooks.com
KIKOBOOKS_API_KEY=your_api_key_here
  1. Build:

npm run build

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "kikobooks": {
      "command": "npx",
      "args": ["-y", "@agentkiko/kikobooks-mcp-server@latest"],
      "env": {
        "KIKOBOOKS_BASE_URL": "https://ai.kikobooks.com",
        "KIKOBOOKS_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "kikobooks": {
      "command": "npx",
      "args": ["-y", "@agentkiko/kikobooks-mcp-server@latest"],
      "env": {
        "KIKOBOOKS_BASE_URL": "https://ai.kikobooks.com",
        "KIKOBOOKS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add kikobooks \
  -e KIKOBOOKS_BASE_URL=https://ai.kikobooks.com \
  -e KIKOBOOKS_API_KEY=your_api_key_here \
  -- npx -y @agentkiko/kikobooks-mcp-server@latest

Cursor / Windsurf

Add the same mcpServers block shown for Claude Desktop to ~/.cursor/mcp.json (Cursor) or ~/.codeium/windsurf/mcp_config.json (Windsurf).

Read-only mode

Write, update, and delete tools load by default. To give an assistant analysis-only access, add these to the env block of any configuration above:

"KIKOBOOKS_DISABLE_WRITE": "true",
"KIKOBOOKS_DISABLE_UPDATE": "true",
"KIKOBOOKS_DISABLE_DELETE": "true"

Only get_*, search_*, and list_* tools are registered in this mode.

Local Development

For local development, point to the built output:

{
  "servers": {
    "kikobooks": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-kiko/dist/index.js"],
      "env": {
        "KIKOBOOKS_BASE_URL": "https://ai.kikobooks.com",
        "KIKOBOOKS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools (116 total)

Chart of Accounts

Tool

Description

search_accounts

Search accounts with filtering by category, type, and text

get_account

Get full account details by ID

create_account

Create a new GL account

update_account

Update an existing account

Customers

Tool

Description

search_customers

Search customers with text search and pagination

get_customer

Get full customer details by ID

create_customer

Create a new customer

update_customer

Update an existing customer

delete_customer

Soft delete (deactivate) a customer

Invoices

Tool

Description

search_invoices

Search invoices with status, customer, date, and overdue filters

get_invoice

Get full invoice details including line items and payments

create_invoice

Create a new invoice with line items

update_invoice

Update an existing invoice

Items (Products/Services)

Tool

Description

search_items

Search products and services

get_item

Get item details including pricing

create_item

Create a new product or service

update_item

Update an existing item

Vendors

Tool

Description

search_vendors

Search vendors with text search

get_vendor

Get full vendor details

create_vendor

Create a new vendor

update_vendor

Update an existing vendor

delete_vendor

Soft delete (deactivate) a vendor

Bills (Accounts Payable)

Tool

Description

search_bills

Search bills with status, vendor, date, and overdue filters

get_bill

Get full bill details including line items

create_bill

Create a new bill

update_bill

Update an existing bill

void_bill

Void a posted bill (reverses accounting impact)

Journal Entries

Tool

Description

search_journal_entries

Search entries with date, source, and posted filters

get_journal_entry

Get full entry with debit/credit lines

create_journal_entry

Create a manual journal entry (debits must equal credits)

post_journal_entry

Post a draft journal entry to the ledger

reverse_journal_entry

Reverse a posted journal entry

Bill Payments (Accounts Payable)

Tool

Description

search_bill_payments

Search bill payments with vendor and date filters

get_bill_payment

Get full bill payment details

create_bill_payment

Create a new bill payment

void_bill_payment

Void a bill payment (reverses accounting impact)

Purchases / Expenses

Tool

Description

search_purchases

Search expense transactions with filters

get_purchase

Get full expense/purchase details

create_purchase

Create a new expense/purchase

update_purchase

Update an existing expense/purchase

delete_purchase

Delete an expense/purchase

Customer Payments (AR)

Tool

Description

search_payments

Search AR payments with customer and date filters

get_payment

Get full payment details

create_payment

Record a customer payment

Credit Memos (AR)

Tool

Description

search_credit_memos

Search credit memos with filters

get_credit_memo

Get full credit memo details

create_credit_memo

Create a new credit memo

Sales Receipts

Tool

Description

search_sales_receipts

Search sales receipts with filters

get_sales_receipt

Get full sales receipt details

create_sales_receipt

Create a new sales receipt

CRM (requires the Sales module)

Tool

Description

search_leads

Search CRM leads

get_lead

Get a lead by ID

create_lead

Create a new lead

search_deals

Search CRM deals (pipeline opportunities)

get_deal

Get a deal by ID

create_deal

Create a new deal from a lead

update_deal

Update an existing deal

get_pipeline

Get the pipeline with stages and per-stage deal counts

move_deal_stage

Move a deal to another pipeline stage

promote_deal_to_customer

Promote a deal's customer (gate before proposal/job)

Proposals (requires the Sales module)

Tool

Description

search_proposals

Search proposals by customer, status, date

get_proposal

Get full proposal details

copy_proposal

Duplicate a proposal into a new draft

generate_invoice_from_proposal

Create a DRAFT invoice from a signed proposal (bridge)

create_job_from_proposal

Create a job with tasks from an accepted proposal (bridge)

Workflow (requires the Workflow module)

Tool

Description

search_jobs

Search jobs (Projects for CB / Engagements for CA)

get_job

Get full job details

list_job_tasks

List the tasks for a job

update_job_status

Update a job's status

update_task_status

Update a task's status (e.g. mark complete)

generate_invoice_from_job

Create a DRAFT invoice from a job's timesheets + expenses (bridge)

Connection & Discovery

Tool

Description

get_connection_status

Report connected / unauthenticated / disconnected — never returns secrets

get_enabled_modules

List which modules (Sales, Workflow) the org has enabled

Reports (read-only)

Tool

Description

get_trial_balance

Trial balance (debit/credit per GL account) as of a date

get_profit_and_loss

Monthly profit & loss (income statement) trend

get_ar_aging

AR aging brackets (current, 1-30, 31-60, 61-90, 90+)

get_ap_aging

AP aging brackets (current, 1-30, 31-60, 61-90, 90+)

get_cash_position

Cash across GL + bank accounts as of a date

get_expense_by_category

Expense breakdown by category

get_income_by_category

Income breakdown by category

get_business_health

Composite business-health indicators

Banking & Reconciliation (read)

Tool

Description

search_bank_accounts

Search bank accounts with paging and filters

get_bank_account

Get a bank account by ID

search_bank_transactions

Search imported bank transactions (append-only evidence)

get_bank_transaction

Get a bank transaction by ID

search_reconciliation_sessions

Search reconciliation sessions

get_reconciliation_summary

Reconciliation summary across accounts

Deposits, Fixed Assets, Recurring, Statements (read)

Tool

Description

search_deposits / get_deposit

Bank deposits and allocated payments

search_fixed_assets / get_fixed_asset

Capitalized assets and depreciation settings

search_recurring_schedules / get_recurring_schedule

Recurring invoice schedules

search_statements / get_statement

Customer AR statements

get_organization_details

Connected org profile and settings

Deposits / Fixed Assets / Recurring / Statements / Reconciliation (write)

Mutating — require a read-write API key and are hidden when KIKOBOOKS_DISABLE_WRITE is set.

Tool

Description

create_deposit / update_deposit / delete_deposit / void_deposit / post_deposit

Full deposit lifecycle (draft → post / void)

create_fixed_asset / update_fixed_asset / dispose_fixed_asset

Fixed-asset register and disposal

run_depreciation

Post depreciation for a fiscal year + period

delete_recurring_schedule / pause_recurring_schedule / resume_recurring_schedule / activate_recurring_schedule / generate_recurring_invoice

Recurring schedule lifecycle

delete_statement / send_statement

Customer statement delete and send

start_reconciliation / complete_reconciliation / cancel_reconciliation / set_statement_balance

Bank reconciliation session lifecycle

Not yet exposed (deferred): create_recurring_schedule, create_statement, and per-transaction bank match/categorize — their request bodies are large nested templates that warrant dedicated design rather than a best-effort mapping.

Scope tiers

Read tools (get_*, search_*, list_*) always load. Mutating tools load by default and are grouped into scope tiers that can be suppressed at startup (set the flag to true or 1):

Env flag

Suppresses

KIKOBOOKS_DISABLE_WRITE

create_*, post_*, reverse_*, move_*, promote_*, copy_*, generate_*, send_*, approve_*, dispose_*, run_*, pause_*, resume_*, activate_*, start_*, complete_*, cancel_*, set_*

KIKOBOOKS_DISABLE_UPDATE

update_*

KIKOBOOKS_DISABLE_DELETE

delete_*, void_*

Security

  • The API key is exchanged for short-lived JWTs. It is never written to disk, logged, or returned to the model.

  • Every call goes through the same permission-checked KikoBooks API your team uses, scoped to the key's organization.

  • Posted ledger entries cannot be edited or deleted through any tool; corrections are reversals or credit memos.

  • MCP clients ask you to confirm tool calls before they run. Review each write before you approve it.

  • Report vulnerabilities to info@accountant.world with the subject "Security vulnerability report".

Privacy and terms

  • This package sends no telemetry. It runs on your machine and talks only to the KIKOBOOKS_BASE_URL you configure.

  • Nothing is written to disk unless you set KIKOBOOKS_TOKEN_STORE_PATH; then only the short-lived session tokens are saved there (owner-only permissions on macOS and Linux), never the API key.

  • Your MCP client and the AI model it uses (for example, Claude or GitHub Copilot) see the tool results you request. Their providers' terms and privacy policies govern that data.

  • Using KikoBooks through this server is covered by the KikoBooks Terms of Service and Privacy Policy. KikoBooks is offered to U.S. businesses only.

Authentication

The server supports two authentication methods:

Set KIKOBOOKS_API_KEY — the server automatically exchanges it for JWT tokens and handles refresh.

Direct Token

Set KIKOBOOKS_ACCESS_TOKEN (and optionally KIKOBOOKS_REFRESH_TOKEN) if you manage tokens externally.

Environment Variables

Variable

Required

Description

KIKOBOOKS_BASE_URL

Yes

KikoBooks API base URL

KIKOBOOKS_API_KEY

Yes*

Org API key for authentication

KIKOBOOKS_ACCESS_TOKEN

Alt*

Direct JWT access token

KIKOBOOKS_REFRESH_TOKEN

No

JWT refresh token

KIKOBOOKS_TOKEN_STORE_PATH

No

Absolute path to persist the rotated JWT between runs (API key is never written)

KIKOBOOKS_DISABLE_WRITE

No

Suppress create/post/action and bridge tools

KIKOBOOKS_DISABLE_UPDATE

No

Suppress update tools

KIKOBOOKS_DISABLE_DELETE

No

Suppress delete/void tools

* Either KIKOBOOKS_API_KEY or KIKOBOOKS_ACCESS_TOKEN is required.

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Lint
npm run lint

Architecture

src/
├── index.ts                 # Entry point
├── config.ts                # Env config (base URL, key, token-store path, scope flags)
├── clients/
│   ├── kikobooks-client.ts   # HTTP client with JWT auth + auto-refresh (get/post/put/delete)
│   └── token-store.ts        # Optional file-backed JWT cache (API key never persisted)
├── server/
│   └── kikobooks-mcp-server.ts  # MCP server singleton
├── tools/                   # Tool definitions grouped by verb, registered via tool-factory
│   ├── tool-factory.ts       # Registers all tools + applies scope-tier gating
│   ├── search/  get/  create/  update/  delete/  action/
│   └── ... (116 tools)
├── handlers/                # Business logic (calls the API client)
├── helpers/                 # register-tool, format-error, get-package-version
└── types/                   # tool-definition, tool-response

Roadmap

See ROADMAP.md for the full implementation plan:

  • Phase 1 ✅ Core Bookkeeping (12 accounting entities)

  • Phase 2 ✅ Practice Management (CRM, Proposals, Workflow) + lifecycle bridges

  • Phase 3 ✅ Banking & Reconciliation

  • Phase 4 ✅ Reports & Analytics

License

MIT — see LICENSE

Available Tools

116 tools
activate_recurring_scheduleA

Activate a DRAFT recurring invoice schedule so it begins generating invoices on its cadence. Confirm with the user first.

Inputs: id (required).

cancel_reconciliationA

Cancel an in-progress reconciliation session (discards its clearing state). Confirm with the user first.

Inputs: id (required).

complete_reconciliationA

Complete/finish a reconciliation session. Fails if a difference remains unless forceComplete is set. Confirm with the user first.

Inputs: id (required), notes, forceComplete.

copy_proposalA

Duplicate an existing proposal into a new draft. Requires the Sales module and the write scope. Confirm with the user before calling.

Inputs: proposal_id (required).

create_accountB

Create a new account in the KikoBooks chart of accounts. Requires account number, name, category (ASSET/LIABILITY/EQUITY/INCOME/EXPENSE), and type code.

Inputs: account (required).

create_billC

Create a new bill (accounts payable) in KikoBooks. Requires vendor ID, dates, and line items.

Inputs: bill (required).

create_bill_paymentB

Create a bill payment (AP) in KikoBooks. Requires vendor ID, payment date, source account, and amount. Optionally apply to specific bills.

Inputs: payment (required).

create_credit_memoB

Create a credit memo (AR) in KikoBooks. Requires customer ID, date, reason code, and at least one line item. Can be linked to a specific invoice.

Inputs: creditMemo (required).

create_customerC

Create a new customer in KikoBooks. Requires at minimum a display name. Optionally include contact details, billing address, and payment terms.

Inputs: customer (required).

create_dealA

Create a new CRM deal (sales opportunity) from a lead. Requires leadId, pipelineStageId, and dealName; optionally include value, currency, status, expected close date, probability, and tags. Requires the Sales module and the write scope. Confirm with the user before calling.

Inputs: deal (required).

create_depositA

Create a bank deposit from undeposited payments/receipts (DR Bank, CR Undeposited Funds on posting). Created as a DRAFT; use post_deposit to post it. Preview and confirm with the user before calling.

Inputs: lines (required), depositDate (required), bank_Account_Id (required), depositToGL_Account_Id (required), +6 more.

create_fixed_assetB

Register a new fixed asset, optionally with depreciation settings (method, useful life, salvage, GL accounts). Preview and confirm with the user first.

Inputs: assetName (required), acquisitionCost (required), acquisitionDate (required), location, +17 more.

create_invoiceC

Create a new invoice in KikoBooks. Requires customer ID, dates, and at least one line item with description, quantity, and unit price.

Inputs: invoice (required).

create_itemB

Create a new product/service item in KikoBooks. Requires a name. Optionally include pricing, type, and account mappings.

Inputs: item (required).

create_job_from_proposalA

Create a job (with tasks) from an accepted proposal's line items — the Proposal → Workflow bridge. Requires proposal_id and job_name. Requires the Sales and Workflow modules and the write scope. Confirm the proposal and job name with the user before calling, then verify with search_jobs.

Inputs: job_name (required), proposal_id (required), archive, option_id, +2 more.

create_journal_entryA

Create a manual journal entry in KikoBooks. Requires entry date and debit/credit lines that balance. Once posted, entries are immutable — corrections require reversal entries.

Inputs: journalEntry (required).

create_leadA

Create a new CRM lead. Requires first and last name; optionally include company, contact details, status, score, source, and tags. Requires the Sales module and the write scope. Preview the details and confirm with the user before calling.

Inputs: lead (required).

create_paymentB

Create a customer payment (AR) in KikoBooks. Requires customer ID, date, method, and amount. Optionally allocate to specific invoices.

Inputs: payment (required).

create_purchaseC

Create a purchase (expense) in KikoBooks. Requires expense date and line items with amounts and expense accounts.

Inputs: purchase (required).

create_sales_receiptB

Create a sales receipt in KikoBooks. Sales receipts record instant payment+sale in one step (no separate invoice needed). Requires date and at least one line item.

Inputs: salesReceipt (required).

create_vendorC

Create a new vendor in KikoBooks. Requires display name. Optionally include contact details, address, and 1099 eligibility.

Inputs: vendor (required).

delete_customerB

Delete (deactivate) a customer in KikoBooks. This performs a soft delete by setting the customer as inactive.

Inputs: customer_id (required).

delete_depositA

Soft-delete a DRAFT deposit. Posted deposits must be voided, not deleted. Confirm with the user first.

Inputs: id (required).

delete_purchaseC

Delete a purchase (expense) in KikoBooks.

Inputs: purchase_id (required).

delete_recurring_scheduleA

Soft-delete a DRAFT recurring invoice schedule. Confirm with the user first.

Inputs: id (required).

delete_statementA

Soft-delete a DRAFT customer statement. Confirm with the user first.

Inputs: id (required).

delete_vendorB

Delete (deactivate) a vendor in KikoBooks. This performs a soft delete by setting the vendor as inactive.

Inputs: vendor_id (required).

dispose_fixed_assetA

Dispose a fixed asset (sale/scrap/donation) — creates a disposal record and updates asset status, recognizing any gain/loss. Confirm with the user first.

Inputs: id (required), disposalDate (required), disposalType (required), disposalProceeds (required), +5 more.

generate_invoice_from_jobA

Generate a DRAFT AR invoice from a job's approved timesheets and billable expenses — the Job → invoice bridge. Creates a draft invoice (does not post to GL). Requires the Workflow module and the write scope. Confirm the job and date with the user before calling, then verify the created invoice with get_invoice.

Inputs: job_id (required), invoice_date (required), due_date, customer_id, +4 more.

generate_invoice_from_proposalA

Generate a DRAFT AR invoice from a signed/contracted proposal — the Proposal → invoice bridge. Maps the selected pricing option's line items onto a new draft invoice (does not post to GL). Requires the Sales module and the write scope. Confirm the proposal and terms with the user before calling, then verify the created invoice with search_invoices or get_invoice.

Inputs: proposal_id (required), due_date, terms_code, invoice_date, +2 more.

generate_recurring_invoiceA

Generate an invoice now from a recurring schedule and advance its next-run date. Creates a DRAFT invoice. Confirm with the user first.

Inputs: id (required).

get_accountA

Get a single chart of accounts entry by ID from KikoBooks. Returns full account details including balances, hierarchy, and metadata.

Inputs: account_id (required).

get_ap_agingA

Get accounts-payable aging brackets (current, 1-30, 31-60, 61-90, 90+ days) — how much is owed to vendors and how overdue. Read-only report.

Inputs: no named parameters.

get_ar_agingA

Get accounts-receivable aging brackets (current, 1-30, 31-60, 61-90, 90+ days) — how much customers owe and how overdue. Read-only report.

Inputs: no named parameters.

get_bank_accountA

Get full details of a single bank account by ID. Read-only.

Inputs: id (required).

get_bank_transactionA

Get full details of a single imported bank transaction by ID. Read-only.

Inputs: id (required).

get_billA

Get a single bill by ID from KikoBooks. Returns full bill details including line items, payment history, and balance due.

Inputs: bill_id (required).

get_bill_paymentB

Get a bill payment (AP) by ID from KikoBooks. Returns full payment details including bill applications.

Inputs: payment_id (required).

get_business_healthA

Get the overall business-health summary (composite financial health indicators and scores) for the organization. Read-only dashboard report.

Inputs: no named parameters.

get_cash_positionB

Get the current cash position across GL cash accounts and bank accounts as of a date. Read-only report.

Inputs: asOfDate.

get_connection_statusA

Report whether the KikoBooks MCP server is connected to an organization. Returns status (connected | unauthenticated | disconnected), whether credentials are configured, and the API base URL. Never returns the API key or any token. Call this first to confirm connectivity before other tools.

Inputs: no named parameters.

get_credit_memoA

Get a credit memo by ID from KikoBooks. Returns full credit memo details including line items and application history.

Inputs: credit_memo_id (required).

get_customerA

Get a single customer by ID from KikoBooks. Returns full customer details including contact info, addresses, and balance.

Inputs: customer_id (required).

get_dealA

Get a single CRM deal by ID with full detail (value, stage, pipeline, linked lead/customer). Requires the Sales module.

Inputs: deal_id (required).

get_depositA

Get full details of a single bank deposit by ID, including its allocated payments. Read-only.

Inputs: id (required).

get_enabled_modulesA

List the modules and capabilities enabled for the connected organization. Bookkeeping and AI are always available. CRM, Proposals (Sales), and Workflow are mandatory for accounting firms (CA) but opt-in for self-service businesses (CB), so call this before offering any sales, proposal, or job/workflow action — if a module is not enabled, do not attempt its tools.

Inputs: no named parameters.

get_expense_by_categoryA

Get the expense breakdown grouped by category/account. Read-only report for understanding where money is being spent.

Inputs: periodBucket.

get_fixed_assetA

Get full details of a single fixed asset by ID, including depreciation settings. Read-only.

Inputs: id (required).

get_income_by_categoryA

Get the income/revenue breakdown grouped by category/account. Read-only report for understanding revenue sources.

Inputs: periodBucket.

get_invoiceA

Get a single invoice by ID from KikoBooks. Returns full invoice details including line items, payments, credits, and balance due.

Inputs: invoice_id (required).

get_itemA

Get a single product/service item by ID from KikoBooks. Returns full item details including pricing and account mapping.

Inputs: item_id (required).

get_jobA

Get a single job (Project/Engagement) by ID with full detail (status, customer, dates, billing). Requires the Workflow module.

Inputs: job_id (required).

get_journal_entryB

Get a single journal entry by ID from KikoBooks. Returns full entry details including debit/credit lines, posting status, and audit hash.

Inputs: entry_id (required).

get_leadA

Get a single CRM lead by ID with full detail (contact info, status, source, linked customer). Requires the Sales module.

Inputs: lead_id (required).

get_organization_detailsA

Get the connected organization's profile — legal name, currency, fiscal settings, and enabled modules. Read-only.

Inputs: no named parameters.

get_paymentA

Get a customer payment (AR) by ID from KikoBooks. Returns full payment details including allocations to invoices.

Inputs: payment_id (required).

get_pipelineA

Get the CRM sales pipeline with its stages and per-stage deal counts — the 'where are my deals' overview. Optionally narrow to one pipeline by ID. Requires the Sales module.

Inputs: pipeline_id.

get_profit_and_lossA

Get the monthly profit & loss (income statement) trend — revenue, expenses, and net profit per month. Read-only. Use trendPeriods to control how many months.

Inputs: trendPeriods.

get_proposalA

Get a single proposal by ID with full detail (status, pricing options, line items, signatures). Requires the Sales module.

Inputs: proposal_id (required).

get_purchaseB

Get a single purchase (expense) by ID from KikoBooks. Returns full purchase details.

Inputs: purchase_id (required).

get_reconciliation_summaryA

Get the bank reconciliation summary across accounts — matched/unmatched counts and cleared balances. Read-only.

Inputs: no named parameters.

get_recurring_scheduleA

Get full details of a single recurring invoice schedule by ID. Read-only.

Inputs: id (required).

get_sales_receiptB

Get a sales receipt by ID from KikoBooks. Returns full receipt details including line items and payment information.

Inputs: sales_receipt_id (required).

get_statementA

Get full details of a single customer statement by ID. Read-only.

Inputs: id (required).

get_trial_balanceA

Get the trial balance (debit/credit balances per GL account) as of a date. Read-only financial report. Optionally filter by account category, type, or code.

Inputs: topN, asOfDate, accountCode, accountType, +2 more.

get_vendorA

Get a single vendor by ID from KikoBooks. Returns full vendor details including contact, addresses, and payment terms.

Inputs: vendor_id (required).

list_job_tasksA

List the tasks for a specific job (Project/Engagement). Filter by status or name. Requires the Workflow module.

Inputs: job_id (required), name, page, status, +1 more.

move_deal_stageA

Move a CRM deal to a different pipeline stage (advance or regress it on the board). Requires the Sales module and the write scope. Preview the target stage and confirm before calling.

Inputs: deal_id (required), target_stage_id (required).

pause_recurring_scheduleA

Pause an active recurring invoice schedule so it stops generating invoices. Confirm with the user first.

Inputs: id (required), pauseReason.

post_depositA

Post a DRAFT deposit to the General Ledger (DR Bank, CR Undeposited Funds). Irreversible except by void. Confirm with the user first.

Inputs: id (required), postingDate.

post_journal_entryA

Post a journal entry to the general ledger in KikoBooks. Once posted, the entry becomes immutable and affects account balances.

Inputs: entry_id (required).

promote_deal_to_customerA

Promote a deal's customer to the 'Customer' lifecycle stage and link it to the deal. This is the required gate before creating a proposal or job from a deal. Requires the Sales module and the write scope. Confirm with the user before calling.

Inputs: deal_id (required).

resume_recurring_scheduleA

Resume a paused recurring invoice schedule. Confirm with the user first.

Inputs: id (required).

reverse_journal_entryA

Reverse a posted journal entry in KikoBooks. Creates a new entry with opposite debits/credits. Posted entries cannot be deleted — only reversed.

Inputs: entry_id (required), reversal_date.

run_depreciationA

Run depreciation for a fiscal year + period — posts all unposted depreciation schedule entries and updates accumulated depreciation. Posts to the GL. Confirm with the user first.

Inputs: fiscalYear (required), periodNumber (required).

search_accountsA

List chart of accounts from KikoBooks. Supports filtering by category (ASSET, LIABILITY, EQUITY, INCOME, EXPENSE), type, and text search. Returns paginated results.

Inputs: page, type, search, category, +1 more.

search_bank_accountsB

Search the organization's bank accounts (connected/manual) with paging and filters. Read-only.

Inputs: page, search, sortBy, status, +4 more.

search_bank_transactionsA

Search imported bank transactions with filters (account, date range, direction, match status, duplicates). Read-only — this is append-only bank evidence.

Inputs: page, dateTo, search, sortBy, +8 more.

search_bill_paymentsB

List bill payments (AP) from KikoBooks. Supports filtering by vendor, status, payment method, date range, and text search. Returns paginated results.

Inputs: page, search, status, toDate, +4 more.

search_billsA

List bills (accounts payable) from KikoBooks. Filter by status, vendor, date range, or overdue status. Returns paginated results.

Inputs: page, dateTo, search, status, +4 more.

search_credit_memosA

List credit memos (AR) from KikoBooks. Supports filtering by customer, status, reason, date range, amount range, and remaining balance. Returns paginated results.

Inputs: page, search, status, toDate, +8 more.

search_customersB

Search customers in KikoBooks. Supports text search across name, company, and email. Returns paginated results with sorting options.

Inputs: page, search, pageSize, sortColumn, +1 more.

search_dealsA

Search CRM deals (sales opportunities) in the pipeline. Filter by status, pipeline, stage, lead, tag, or text. Requires the Sales module — call get_enabled_modules first for CB orgs. Returns paginated results.

Inputs: page, tagId, leadId, search, +4 more.

search_depositsB

Search bank deposits (grouped undeposited payments moved to a bank account) with filters. Read-only.

Inputs: page, dateTo, sortBy, status, +6 more.

search_fixed_assetsB

Search fixed assets (capitalized property/equipment) with filters by category, status, depreciation method, location, or department. Read-only.

Inputs: page, search, status, location, +6 more.

search_invoicesC

Search invoices in KikoBooks. Filter by status (DRAFT, PENDING, SENT, PAID, etc.), customer, date range, or overdue status. Returns paginated results.

Inputs: page, search, status, isPosted, +13 more.

search_itemsC

List products/services (items) from KikoBooks. Returns paginated results with search support.

Inputs: page, search, pageSize.

search_jobsA

Search jobs (shown as 'Projects' for self-service businesses, 'Engagements' for accounting firms). Filter by customer, status, name, or tags. Requires the Workflow module — call get_enabled_modules first for CB orgs. Returns paginated results.

Inputs: name, page, tags, status, +3 more.

search_journal_entriesA

List journal entries from KikoBooks general ledger. Filter by date range, source (MANUAL, AR_INVOICE, AP_BILL, etc.), and posted status. Posted entries are immutable.

Inputs: page, dateTo, posted, search, +3 more.

search_leadsA

Search CRM leads (prospective customers). Filter by status, lead source, tag, or text. Requires the Sales module — call get_enabled_modules first for self-service (CB) orgs. Returns paginated results.

Inputs: page, tagId, search, status, +2 more.

search_paymentsB

List customer payments (AR) from KikoBooks. Supports filtering by customer, status, payment method, date range, and text search. Returns paginated results.

Inputs: page, search, status, pageSize, +4 more.

search_proposalsA

Search proposals in KikoBooks. Filter by customer, status (draft, sent, signed, declined), name, source, or date range. Requires the Sales module — call get_enabled_modules first for CB orgs. Returns paginated results.

Inputs: name, page, source, status, +5 more.

search_purchasesC

Search purchases (expenses) in KikoBooks. Supports filtering by vendor, status, date range, and text search.

Inputs: page, dateTo, search, status, +5 more.

search_reconciliation_sessionsA

Search bank reconciliation sessions (open and completed) with filters by account and status. Read-only.

Inputs: page, status, pageSize, accountId.

search_recurring_schedulesA

Search recurring invoice schedules (templates that auto-generate invoices on a cadence) with filters. Read-only.

Inputs: page, dateTo, sortBy, status, +6 more.

search_sales_receiptsA

List sales receipts from KikoBooks. Sales receipts record instant payments (no invoice needed). Supports filtering by customer, status, payment method, and date range.

Inputs: page, dateTo, status, dateFrom, +4 more.

search_statementsB

Search customer statements (periodic AR statements sent to customers) with filters. Read-only.

Inputs: page, dateTo, sortBy, dateFrom, +6 more.

search_vendorsC

Search vendors in KikoBooks. Supports text search by name or company. Returns paginated results.

Inputs: page, search, pageSize.

send_statementA

Send a customer statement to the customer (email). Show the recipient to the user and confirm before sending.

Inputs: id (required), deliveryMethod, recipientEmail.

set_statement_balanceA

Update the closing statement balance on an in-progress reconciliation session. Confirm with the user first.

Inputs: id (required), statementBalance (required).

start_reconciliationA

Start a bank reconciliation session for an account over a statement period, seeded with the closing statement balance. Confirm with the user first.

Inputs: periodEnd (required), periodStart (required), bank_Account_Id (required), statementBalance (required), +1 more.

update_accountC

Update an existing account in the KikoBooks chart of accounts. Provide the account ID and the fields to update.

Inputs: account (required), account_id (required).

update_billB

Update an existing bill in KikoBooks. Only DRAFT/PENDING bills can be fully edited.

Inputs: bill (required), bill_id (required).

update_customerC

Update an existing customer in KikoBooks. Provide the customer ID and the fields to update.

Inputs: customer (required), customer_id (required).

update_dealA

Update an existing CRM deal. Supply the deal_id and the full deal object (leadId, pipelineStageId, and dealName are required). Use this to change value, status, close date, or probability. Requires the Sales module and the write scope. Read the current deal first (get_deal), then confirm changes.

Inputs: deal (required), deal_id (required).

update_depositA

Update a DRAFT bank deposit. Posted deposits cannot be edited. Preview and confirm with the user first.

Inputs: id (required), lines (required), depositDate (required), bank_Account_Id (required), +6 more.

update_fixed_assetA

Update a fixed asset. Financial fields are locked once depreciation has been posted. Confirm with the user first.

Inputs: id (required), assetName (required), acquisitionCost (required), acquisitionDate (required), +18 more.

update_invoiceA

Update an existing invoice in KikoBooks. Only DRAFT invoices can be fully edited. For posted invoices, only status changes and memo updates are allowed.

Inputs: invoice (required), invoice_id (required).

update_itemC

Update an existing product/service item in KikoBooks.

Inputs: item (required), item_id (required).

update_job_statusA

Update a job's (Project/Engagement) status. Requires the Workflow module and the write scope. Read the current job first (get_job) and confirm the new status with the user before calling.

Inputs: job_id (required), status (required).

update_purchaseC

Update an existing purchase (expense) in KikoBooks.

Inputs: purchase (required), purchase_id (required).

update_task_statusA

Update a job task's status (e.g. mark a task complete). Requires the Workflow module and the write scope. List tasks first (list_job_tasks) and confirm the new status with the user before calling.

Inputs: status (required), task_id (required), sub_domain.

update_vendorC

Update an existing vendor in KikoBooks. Provide the vendor ID and the fields to update.

Inputs: vendor (required), vendor_id (required).

void_billA

Void a bill in KikoBooks. Voiding marks the bill as cancelled and reverses any accounting impact. Only applicable to posted bills.

Inputs: bill_id (required).

void_bill_paymentA

Void a bill payment (vendor payment) in KikoBooks. Voiding reverses the payment's accounting impact without physically deleting the record.

Inputs: payment_id (required).

void_depositA

Void a deposit (sets status to VOID with a reversing effect). Use instead of delete for posted deposits. Confirm with the user first.

Inputs: id (required), voidReason.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 116 tools

    Disambiguation4/5

    Most tools map to a distinct resource plus action, and descriptions clarify boundaries such as search_bills versus search_bill_payments. A few overlaps remain—update_deal versus move_deal_stage, get_payment versus get_bill_payment, and search_accounts versus search_bank_accounts—but overall selection is largely manageable.

    Naming Consistency5/5

    All tool names use snake_case with a verb_noun pattern (search_/get_/create_/update_/delete_/void_/post_/generate_). Minor variations such as list_job_tasks and action-specific verbs still follow the same predictable convention.

    Tool Count1/5

    116 tools is extreme for a single MCP server, far beyond the 3-15 well-scoped range and well past the 50+ threshold. The surface is overwhelming and likely to strain tool selection, even if many tools are individually justified.

    Completeness3/5

    The server covers search/get/create/update for many core entities and includes reports, banking, fixed assets, and CRM flows. However, notable lifecycle gaps exist: proposals have no create/update/send tools, jobs lack direct creation and timesheet tools despite invoice-from-timesheet support, and invoices lack void/send operations.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that connects AI assistants like Claude to Moneybird accounting software, enabling management of contacts, financial data, products, and business operations through natural language.
      29
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol server that enables LLMs to securely interact with Alegra accounting API, allowing operations on invoices, contacts, and items data.
      1
      221 npm
      1
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with Kanta API for managing clients, users, persons, and accessing risk summaries and firm information.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that bridges Odoo ERP systems with AI agents, enabling them to access and manipulate partner information, accounting data, invoices, and perform financial reconciliation through a standardized interface.
      MIT