KikoBooks MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@KikoBooks MCP Server list my unpaid invoices from last month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_modulesfirst 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
npxcommand pulls it from npm automatically. The steps below are for local development / contributing.
Install dependencies:
npm installCreate a
.envfile (copy from.env.example):
KIKOBOOKS_BASE_URL=https://ai.kikobooks.com
KIKOBOOKS_API_KEY=your_api_key_hereBuild:
npm run buildConfiguration
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@latestCursor / 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 with filtering by category, type, and text |
| Get full account details by ID |
| Create a new GL account |
| Update an existing account |
Customers
Tool | Description |
| Search customers with text search and pagination |
| Get full customer details by ID |
| Create a new customer |
| Update an existing customer |
| Soft delete (deactivate) a customer |
Invoices
Tool | Description |
| Search invoices with status, customer, date, and overdue filters |
| Get full invoice details including line items and payments |
| Create a new invoice with line items |
| Update an existing invoice |
Items (Products/Services)
Tool | Description |
| Search products and services |
| Get item details including pricing |
| Create a new product or service |
| Update an existing item |
Vendors
Tool | Description |
| Search vendors with text search |
| Get full vendor details |
| Create a new vendor |
| Update an existing vendor |
| Soft delete (deactivate) a vendor |
Bills (Accounts Payable)
Tool | Description |
| Search bills with status, vendor, date, and overdue filters |
| Get full bill details including line items |
| Create a new bill |
| Update an existing bill |
| Void a posted bill (reverses accounting impact) |
Journal Entries
Tool | Description |
| Search entries with date, source, and posted filters |
| Get full entry with debit/credit lines |
| Create a manual journal entry (debits must equal credits) |
| Post a draft journal entry to the ledger |
| Reverse a posted journal entry |
Bill Payments (Accounts Payable)
Tool | Description |
| Search bill payments with vendor and date filters |
| Get full bill payment details |
| Create a new bill payment |
| Void a bill payment (reverses accounting impact) |
Purchases / Expenses
Tool | Description |
| Search expense transactions with filters |
| Get full expense/purchase details |
| Create a new expense/purchase |
| Update an existing expense/purchase |
| Delete an expense/purchase |
Customer Payments (AR)
Tool | Description |
| Search AR payments with customer and date filters |
| Get full payment details |
| Record a customer payment |
Credit Memos (AR)
Tool | Description |
| Search credit memos with filters |
| Get full credit memo details |
| Create a new credit memo |
Sales Receipts
Tool | Description |
| Search sales receipts with filters |
| Get full sales receipt details |
| Create a new sales receipt |
CRM (requires the Sales module)
Tool | Description |
| Search CRM leads |
| Get a lead by ID |
| Create a new lead |
| Search CRM deals (pipeline opportunities) |
| Get a deal by ID |
| Create a new deal from a lead |
| Update an existing deal |
| Get the pipeline with stages and per-stage deal counts |
| Move a deal to another pipeline stage |
| Promote a deal's customer (gate before proposal/job) |
Proposals (requires the Sales module)
Tool | Description |
| Search proposals by customer, status, date |
| Get full proposal details |
| Duplicate a proposal into a new draft |
| Create a DRAFT invoice from a signed proposal (bridge) |
| Create a job with tasks from an accepted proposal (bridge) |
Workflow (requires the Workflow module)
Tool | Description |
| Search jobs (Projects for CB / Engagements for CA) |
| Get full job details |
| List the tasks for a job |
| Update a job's status |
| Update a task's status (e.g. mark complete) |
| Create a DRAFT invoice from a job's timesheets + expenses (bridge) |
Connection & Discovery
Tool | Description |
| Report connected / unauthenticated / disconnected — never returns secrets |
| List which modules (Sales, Workflow) the org has enabled |
Reports (read-only)
Tool | Description |
| Trial balance (debit/credit per GL account) as of a date |
| Monthly profit & loss (income statement) trend |
| AR aging brackets (current, 1-30, 31-60, 61-90, 90+) |
| AP aging brackets (current, 1-30, 31-60, 61-90, 90+) |
| Cash across GL + bank accounts as of a date |
| Expense breakdown by category |
| Income breakdown by category |
| Composite business-health indicators |
Banking & Reconciliation (read)
Tool | Description |
| Search bank accounts with paging and filters |
| Get a bank account by ID |
| Search imported bank transactions (append-only evidence) |
| Get a bank transaction by ID |
| Search reconciliation sessions |
| Reconciliation summary across accounts |
Deposits, Fixed Assets, Recurring, Statements (read)
Tool | Description |
| Bank deposits and allocated payments |
| Capitalized assets and depreciation settings |
| Recurring invoice schedules |
| Customer AR statements |
| 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 |
| Full deposit lifecycle (draft → post / void) |
| Fixed-asset register and disposal |
| Post depreciation for a fiscal year + period |
| Recurring schedule lifecycle |
| Customer statement delete and send |
| 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 |
|
|
|
|
|
|
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_URLyou 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:
API Key (Recommended)
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 |
| Yes | KikoBooks API base URL |
| Yes* | Org API key for authentication |
| Alt* | Direct JWT access token |
| No | JWT refresh token |
| No | Absolute path to persist the rotated JWT between runs (API key is never written) |
| No | Suppress create/post/action and bridge tools |
| No | Suppress update tools |
| 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 lintArchitecture
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-responseRoadmap
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
Links
Accountant Inc. — publisher of KikoBooks, Accountant.World, and Agent Kiko
Available Tools
116 toolsactivate_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
Scored across 116 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A Model Context Protocol server for Wix AI tools
Query your books, company data, business health, and ship invoices from your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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.29MIT
- AlicenseBqualityCmaintenanceA Model Context Protocol server that enables LLMs to securely interact with Alegra accounting API, allowing operations on invoices, contacts, and items data.1221 npm1ISC
- FlicenseNot gradedqualityDmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceA 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