Skip to main content
Glama

Switchbooks

Server Details

Bookkeeping and accounting: P&L, balance sheet, cash flow, transactions, accounts, payees, rules.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
drylandbeard/switchbooks-mcp
GitHub Stars
0
Server Listing
Switchbooks MCP Server
ChatGPT
–
Claude
Switchbooks

TDQS

B3.4/5.0

Scored across 17 tools

Disambiguation4/5

Each tool maps to a distinct bookkeeping resource (accounts, categories, classes, journal entries, payees, rules, transactions, reports, reconciliations, files, requests, changes) and the descriptions actively steer the agent (read books_glance first, use list_companies before set_company). The main residual overlap is between books_glance and the aggregate tools — cash/review status/reconciliation timing also appear in manage_reports, manage_transactions, and manage_reconciliations — plus two different 'suggest' actions (manage_transactions vs manage_rules) that require reading descriptions to separate.

Naming Consistency4/5

A predictable manage_<resource> family covers 12 tools, with supporting verb_noun names (list_companies, set_company, get_switchbooks_info) and one noun-first outlier (books_glance). The convention is readable and stable, though 'manage_' is a vague verb for tools that are almost all read-only single-action (list/read/preview) operations.

Tool Count4/5

17 tools is on the heavy side but each corresponds to a genuine bookkeeping entity or workflow (chart of accounts, classes, journal entries, reconciliations, rules, reports), so nothing feels gratuitous. A slight trim (e.g. folding accounts/reconciliations or company profile into books_glance) would bring it into the ideal 3-15 range.

Completeness4/5

Read coverage is broad and well-matched to the stated read-only purpose: overview, guidance, company scoping, all core ledgers, reports, reconciliation previews, and pending-request review. The notable gap is the write half of the bookkeeping lifecycle — no creating/updating journal entries or transactions, no applying categorization or saving rules, no sending requests — which the descriptions acknowledge but still leaves the surface one-directional.

Available Tools

17 tools
books_glanceBooks at a GlanceA
Read-onlyIdempotent
Inspect

The active company's books at a glance: last month and year to date against the prior period, cash, what waits in To Review, reconciliations and through when, month-end entries, the chart of accounts with what each category holds, what looks off, and the company's "How we keep these books" notes, which everyone on the company sees. Read it first; answer from it when it covers the question.

Inputs: no named parameters.

get_switchbooks_infoRead Switchbooks HelpA
Read-onlyIdempotent
Inspect

Read Switchbooks product and bookkeeping guidance for a topic selected by name. Use the topic values in the input schema to understand supported workflows, including journal entries, reports, reconciliation, payroll, and loans.

Inputs: name.

list_companiesList Accessible CompaniesA
Read-onlyIdempotent
Inspect

List the Switchbooks companies available to the authenticated account, including their IDs, names, legal entity names, descriptions, and which company is currently active. Results identify the available company scope for subsequent bookkeeping reads.

Inputs: no named parameters.

manage_accountsInspect Bank and Credit Card AccountsC
Read-onlyIdempotent
Inspect

List the active company's bank and credit card accounts. Supply name to inspect balances and connection details. reviewConnection reads available account choices and existing connections without changing them; connect applies the user's choices. Set action to one of: list, inspect, reviewConnection.

Inputs: date, name, type, names, +10 more.

manage_categoriesBrowse Accounting CategoriesB
Read-onlyIdempotent
Inspect

List accounting categories for the active company, including their account types. Supply name or names to find categories, tree=true to view their hierarchy, or unusedOnly=true to find unused categories. Set companies to compare several companies' charts side by side. Use offset to continue a paginated list. Set action to one of: list.

Inputs: keep, name, rows, tree, +9 more.

manage_changesReview Agent Change HistoryA
Read-onlyIdempotent
Inspect

List recent batches of changes made by the Switchbooks agent in the active company. Use the history to understand what changed and when. Use offset to continue a paginated list; this connection cannot undo changes. Set action to one of: list.

Inputs: name, action, offset, company.

manage_classesBrowse ClassesB
Read-onlyIdempotent
Inspect

List the active company's classes, the locations, departments or properties its P&L can be read by, including archived and merged ones. Set action to one of: list.

Inputs: name, names, action, company, +1 more.

manage_companyRead Company Profile and TeamB
Read-onlyIdempotent
Inspect

Read the active company's profile, including its name, legal entity name, business description, and billing status. Use read for the profile or team to list members and pending invitations. These actions do not change company settings or team access. Set action to one of: read, team.

Inputs: key, body, name, role, +19 more.

manage_filesRead Bookkeeping FilesB
Read-onlyIdempotent
Inspect

List stored bookkeeping files for the active company or read selected files by their exact name or names. List files first to obtain their names, then read the relevant documents. Use offset to continue a paginated result. This connection does not import files or change attachments. Set action to one of: list, read.

Inputs: by, ref, date, name, +17 more.

manage_journal_entriesSearch Journal EntriesB
Read-onlyIdempotent
Inspect

Find journal entries in the active company and inspect their accounting lines. Filter by entry reference, name, account, or a date range using YYYY-MM-DD dates. Use offset to continue a paginated list. Journal entries are separate from bank and credit card transactions. Set action to one of: list.

Inputs: ref, date, file, kind, +23 more.

manage_payeesFind PayeesB
Read-onlyIdempotent
Inspect

List payees for the active company or find close spelling matches using name or names. Set unusedOnly=true to list payees with no usage. Use offset to continue a paginated list. Set action to one of: list.

Inputs: keep, name, rows, names, +5 more.

manage_reconciliationsReview ReconciliationsB
Read-onlyIdempotent
Inspect

Review reconciliation history or compare an account with a statement ending date and balance. A preview identifies differences before a reconciliation is finished. Set action to one of: history, preview.

Inputs: date, file, names, action, +8 more.

manage_reportsRead Financial ReportsA
Read-onlyIdempotent
Inspect

Read profit and loss (pnl), balance sheet (balanceSheet), cash flow (cashFlow), and trial balance (trialBalance, as of endDate) reports for the active company. Inspect supporting entries and totals, compare periods, summarize spending by payee, or generate forecasts. For an account ledger, use details with category set to the account name. For a P&L by company, read pnl with companies: one column per company and a Total. The transactions, journalEntries, uncategorized, and generalLedger report values are spreadsheet exports, made in the Switchbooks web app. Dates use YYYY-MM-DD. Set action to one of: read, details, forecast.

Inputs: by, file, refs, month, +14 more.

manage_requestsReview Client RequestsB
Read-onlyIdempotent
Inspect

Read recent requests to the active company's owner: questions, transactions to clarify and missing files, with answers and uploaded file names. It does not create requests or send email on this connection. Set action to one of: list, link.

Inputs: to, asks, note, refs, +7 more.

manage_rulesReview Categorization RulesA
Read-onlyIdempotent
Inspect

Review the active company's automatic transaction categorization rules, preview which pending transactions match proposed conditions or a saved rule, or identify patterns for suggested rules. Supply name or names to find existing rules by their words, the category or payee they set, or "#N" for the rule at rank N; set and unusedOnly narrow the list. Use when and match to define preview conditions. Previews and suggestions do not save rules or change transactions. Set action to one of: list, preview, suggest.

Inputs: set, name, when, match, +8 more.

manage_transactionsSearch and Review TransactionsC
Read-onlyIdempotent
Inspect

Search the active company's transactions, summarize bookkeeping activity, or request categorization suggestions. Filter by account, category, payee, description, amount, transaction reference, date, or state (pending, posted, or all). Use YYYY-MM-DD dates and offset for pagination. To review the whole company, use state=all without filters. Suggestions do not apply changes. Set action to one of: list, review, suggest.

Inputs: by, ref, set, why, +26 more.

set_companySelect Active CompanyA
Idempotent
Inspect

Select the active company for this connection using a company ID, exact name, or unique name fragment from list_companies. Saves the company selection for subsequent bookkeeping reads without changing bookkeeping records. Only companies accessible to the authenticated account can be selected. When several agents share this connection, pin true keeps the active company from moving until pin false, so no agent switches another; each names any other company in the company field of its own calls.

Inputs: company (required), pin.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      Talk to your GnuCash books: a one-call financial dashboard (net worth, runway, budgets, what's overdue), and whole bank statements entered and reconciled in a single call from CSV, OFX, PDF, or even a screenshot or photo of the statement. Plus transactions, invoices, reports and multi-currency; local, SQLite/PostgreSQL/MySQL.
      87
      89
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Double-entry books an agent keeps as the user, on your own Postgres or Supabase: invoices, VAT returns, bank reconciliation, financial statements and 130 country packs.
      42
      AGPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants and scripts to read, analyze and safely write self-hosted personal finance books, covering accounts, transactions, categories, tags, monthly and category reports, net worth, cash flow, recurring payments, installment plans and bulk imports. Writes are safeguarded with dry runs, delete confirmation, and an optional read-only mode, while amounts are returned exactly as both minor units and decimal strings with totals kept per currency.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to operate a self-hosted double-entry personal finance ledger: answering spending, net-worth and cash-flow forecast questions, searching transactions, and managing schedules, rules and imports through audited, reversible tools. Read and write access is scoped by token, with privacy controls over what financial details reach the agent.
      AGPL 3.0
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.