# Codat MCP by usefulapi

> Codat MCP by usefulapi is a freemium MCP server for finance and payments. Hosted MCP server that lets AI assistants read Codat accounting data for companies. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, Chrome extension, vscode
- **Website:** https://usefulapi.io/codat/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/codat
- **MCP Registry name:** io.usefulapi/codat
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The README describes a hosted endpoint that connects Claude, ChatGPT, Cursor and other MCP clients to Codat, a unified accounting data API covering platforms such as QuickBooks and Xero. Nothing needs to be installed locally; you sign in with your own Codat API key through an OAuth login page.

Once connected, the assistant can pull profit and loss, balance sheet and cash flow statements by period, list invoices, bills, payments and credit notes, and check how fresh each dataset is. Four tools can also create companies, create data connections and queue refreshes, so write access is a separate step the client asks you to approve.

The server is aimed at fintech developers and lenders who read their customers' bookkeeping data through Codat. usefulapi is an independent service and is not affiliated with or endorsed by Codat.

## Features

- **Financial statement reports:** Retrieves profit and loss, balance sheet and cash flow statements split into periods you choose.
- **Receivables and payables lists:** Lists customer invoices with an amount-due filter and supplier bills with due dates.
- **Data freshness checks:** Shows the last successful sync and current status for each accounting data type.
- **Payments and journal review:** Lists payments, bill payments, credit notes and journal entries for a company.
- **Connection management:** Creates companies and data connections and returns an authorization link for the customer.
- **Remote setup with OAuth:** Works as a hosted Streamable HTTP server, so clients need only the URL and a one-time login.

## Good for

- Check which customer invoices are still unpaid for a client company
- Compare profit and loss across several recent periods
- Confirm whether accounting data has synced before running an analysis
- Review supplier bills and bill payments owed by a business
- Queue a data refresh when a customer's books have changed

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http codat https://codat.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://codat.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "codat": {
      "url": "https://codat.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "codat": {
      "type": "http",
      "url": "https://codat.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "codat": {
      "serverUrl": "https://codat.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "codat": {
      "type": "http",
      "url": "https://codat.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `codat_get_profile`: Fetch the authenticated Codat account's profile (organization name, redirect URLs, features) — a quick way to verify the API key works. Codat API: GET /profile.
- `codat_list_companies`: List the companies in your Codat account. A company represents one of your customers' businesses and holds its data connections. Codat API: GET /companies. Returns the paged envelope { results, pageNumber, pageSize, totalResults, _links }.
- `codat_get_company`: Fetch a single company by id (name, platform, dataConnections, created/lastSync). Codat API: GET /companies/{companyId}.
- `codat_list_connections`: List a company's data connections (each links the company to one source platform, e.g. QuickBooks, Xero). Codat API: GET /companies/{companyId}/connections. Returns the paged envelope.
- `codat_get_connection`: Fetch a single data connection by id (platformKey, status, sourceType, lastSync). Codat API: GET /companies/{companyId}/connections/{connectionId}.
- `codat_get_data_status`: Get the freshness/status of each accounting data type for a company (lastSuccessfulSync, currentStatus, dataType). Use this to check whether a dataset has been pulled before reading it. Codat API: GET /companies/{companyId}/dataStatus.
- `codat_get_data_info`: Get a company's accounting metadata (base currency, supported data types, etc.). Codat API: GET /companies/{companyId}/data/info.
- `codat_list_integrations`: List the accounting/commerce/banking platforms (integrations) Codat supports, with their platformKey. Codat API: GET /integrations. Returns the paged envelope.
- `codat_list_accounts`: List a company's chart of accounts (id, name, nominalCode, type, status, currency, currentBalance). Codat API: GET /companies/{companyId}/data/accounts. Returns the paged envelope.
- `codat_list_invoices`: List a company's accounts-receivable invoices (id, invoiceNumber, customerRef, issueDate, dueDate, currency, totalAmount, amountDue, status, lineItems). Codat API: GET /companies/{companyId}/data/invoices. Returns the paged envelope. Tip: filter with query, e.g. "status=Submitted&&amountDue>0".
- `codat_get_invoice`: Fetch a single AR invoice by id (full object incl. lineItems, paymentAllocations). Codat API: GET /companies/{companyId}/data/invoices/{invoiceId}.
- `codat_list_bills`: List a company's accounts-payable bills (id, reference, supplierRef, issueDate, dueDate, currency, totalAmount, amountDue, status, lineItems). Codat API: GET /companies/{companyId}/data/bills. Returns the paged envelope.
- `codat_list_bill_payments`: List a company's bill payments (money paid out to suppliers) — id, supplierRef, date, currency, totalAmount, lines. Codat API: GET /companies/{companyId}/data/billPayments. Returns the paged envelope.
- `codat_list_credit_notes`: List a company's credit notes (id, creditNoteNumber, customerRef, issueDate, currency, totalAmount, remainingCredit, status). Codat API: GET /companies/{companyId}/data/creditNotes. Returns the paged envelope.
- `codat_list_customers`: List a company's customers (id, customerName, contactName, emailAddress, addresses, status, defaultCurrency). Codat API: GET /companies/{companyId}/data/customers. Returns the paged envelope.
- `codat_list_suppliers`: List a company's suppliers/vendors (id, supplierName, contactName, emailAddress, addresses, status, defaultCurrency). Codat API: GET /companies/{companyId}/data/suppliers. Returns the paged envelope.
- `codat_list_payments`: List a company's payments received (money in against invoices) — id, customerRef, date, currency, totalAmount, lines/allocations. Codat API: GET /companies/{companyId}/data/payments. Returns the paged envelope.
- `codat_list_journal_entries`: List a company's journal entries (id, postedOn, createdOn, journalLines with accountRef/netAmount/currency). Codat API: GET /companies/{companyId}/data/journalEntries. Returns the paged envelope.
- `codat_get_balance_sheet`: Get a company's balance sheet, broken into periods. periodLength (months per period) and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/balanceSheet.
- `codat_get_profit_and_loss`: Get a company's profit and loss (income statement), broken into periods. periodLength and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/profitAndLoss.
- `codat_get_cash_flow_statement`: Get a company's cash flow statement, broken into periods. periodLength and periodsToCompare are BOTH required by Codat. Codat API: GET /companies/{companyId}/data/financials/cashFlowStatement.
- `codat_list_direct_costs`: List a company's direct costs (point-of-sale purchases: card/cash spend, refunds) for a data connection. NOTE: this endpoint is CONNECTION-scoped. Codat API: GET /companies/{companyId}/connections/{connectionId}/data/directCosts. Returns the paged envelope.
- `codat_list_account_transactions`: List a company's account transactions (bank/GL transactions) for a data connection. NOTE: this endpoint is CONNECTION-scoped. Codat API: GET /companies/{companyId}/connections/{connectionId}/data/accountTransactions. Returns the paged envelope.
- `codat_request`: Power-user escape hatch: GET any Codat API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path starts with a slash (e.g. "/companies/{id}/data/taxRates", "/companies/{id}/reports/agedDebtor"). Codat API: GET {path}.
- `codat_create_company`: MUTATES Codat data — create a new company (a container for a customer's data connections). Provide a name; optionally a description, tags, or other attributes via `fields`. Codat API: POST /companies. Returns the created company (incl. its id).
- `codat_create_connection`: MUTATES Codat data — create a new data connection on a company for a given source platform. Provide the platformKey (from codat_list_integrations, e.g. "gbol" for QuickBooks Online sandbox). The connection is created in a PendingAuth state; the customer completes authorization via the returned linkUrl. Codat API: POST /companies/{companyId}/connections. Returns the created connection.
- `codat_refresh_all_data`: MUTATES Codat state — queue a refresh of ALL data types for a company (Codat re-pulls from the connected source platforms). Asynchronous: it enqueues pulls, it does not return the data. Use codat_get_data_status to track progress. Codat API: POST /companies/{companyId}/data/all.
- `codat_refresh_data_type`: MUTATES Codat state — queue a refresh of ONE data type for a company (e.g. "invoices", "bills", "chartOfAccounts", "balanceSheet"). Asynchronous: it enqueues a pull, it does not return the data. Codat API: POST /companies/{companyId}/data/queue/{dataType}.

## FAQ

### Is this an official Codat product?

No. The site states usefulapi is an independent service, not affiliated with or endorsed by Codat.

### What do I need to connect?

The login page asks for your Codat API key. The README says the key is validated and stored per user.

### Can the AI change my Codat data?

Yes, if you approve it. Four of the 28 listed tools can create or change data; the page says most clients ask for approval before a tool call runs.

### What does it cost?

The page lists a Free plan with 50 tool calls a month, Pro at $9/mo or $90/yr with 10,000 calls, and Pro+ at $39/mo or $390/yr with 100,000 calls.

### Is Codat MCP by usefulapi free?

Codat MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Codat MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http codat https://codat.usefulapi.io/mcp

### What are the best alternatives to Codat MCP by usefulapi?

The closest alternatives to Codat MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/codat-mcp-by-usefulapi
