# SuperBooks

> SuperBooks is an MCP server for finance and payments. Accounting server for invoices, customers, time tracking and reports via 244 operations. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** Web, API
- **Website:** https://docs.superbooks.io/mcp
- **MCP Registry name:** io.superbooks/superbooks
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-15

## About

SuperBooks exposes its whole app through a code-mode interface. A client sees exactly two tools, search_tools and execute_typescript. The assistant searches for the operations its credential can reach, then runs a short TypeScript program calling them. Behind that sit 244 operations covering books, invoicing, reports, time tracking, bank and app connections, billing, account, team, support and API keys, each with its own scope and authentication.

One connection can cover several teams, chosen on the consent screen, and membership is checked on every request. A call that omits teamId when several teams are covered is refused with TEAM_REQUIRED, and list_teams shows which teams are covered. The docs advise ticking specific teams rather than all, because an assistant can carry what it reads in one team into another.

The consent screen marks known clients as Verified, labels local ones such as Claude Code as running on your computer and makes unknown clients tick a box confirming the address. Rate limits count MCP requests, 120 per minute, rather than tool calls. Delete, send or overwrite tools ask for confirmation with a single-use token.

## Features

- **Code mode access:** Two tools reach 244 operations across books, invoicing and reports.
- **Multi-team connections:** One connection can cover up to 100 teams, with a teamId per call.
- **Verified clients:** The consent screen shows whether a client is verified.
- **OAuth or API key:** Sign in with OAuth or use an sb_ key created via create_api_key.
- **Confirmation tokens:** Destructive tools need a single-use confirmation before they run.
- **Read-only grants:** A read-only connection stays read-only in every team.

## Good for

- Ask an assistant to prepare an invoice for a customer
- Pull a financial report from chat
- Log time entries against a client
- Review transactions across several teams
- Create an API key for a script

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http superbooks https://app.superbooks.io/mcp
```

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

```sh
https://app.superbooks.io/mcp
```

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

```json
{
  "mcpServers": {
    "superbooks": {
      "url": "https://app.superbooks.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "superbooks": {
      "serverUrl": "https://app.superbooks.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://app.superbooks.io/mcp
```

Enter a Name (for example "SuperBooks"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

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

## Tools

- `search_tools`: Discovers the operations your credential can reach.
- `execute_typescript`: Runs a short TypeScript program that calls SuperBooks operations.
- `list_teams`: Returns the teams the connection covers with ids, names and your role.
- `create_api_key`: Creates an API key from a connected agent.

## FAQ

### Which clients can connect?

Any MCP client supporting Streamable HTTP, including Claude, Claude Code, Cursor, Windsurf, ChatGPT, Codex and VS Code.

### What is the rate limit?

120 MCP requests per minute, counted per request rather than per tool call.

### How do I handle several teams?

Pass teamId on each call; list_teams returns the teams the connection covers.

### Do I need an API key?

Not with OAuth. Clients that want a static header can use a key from create_api_key or the Developer settings page.

### How do I add SuperBooks to Claude Code?

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

### What are the best alternatives to SuperBooks?

The closest alternatives to SuperBooks are Switchbooks, Sevdesk MCP, ClearBooks AI accounting, YESbusiness and Multi Books.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Switchbooks](https://ai-powered.com/mcp/switchbooks): Switchbooks is an MCP server for finance and payments.
- [Sevdesk MCP](https://ai-powered.com/mcp/sevdesk-mcp): Sevdesk MCP is a free MCP server for finance and payments.
- [ClearBooks AI accounting](https://ai-powered.com/mcp/clearbooks-ai-accounting): ClearBooks AI accounting is a freemium MCP server for finance and payments.
- [YESbusiness](https://ai-powered.com/mcp/yesbusiness): YESbusiness is an MCP server for finance and payments.
- [Multi Books](https://ai-powered.com/mcp/multi-books): Multi Books is a paid MCP server for finance and payments.
- [FutureSense](https://ai-powered.com/mcp/futuresense): FutureSense is a freemium MCP server for finance and payments.
- [Sage Intacct MCP by superglue](https://ai-powered.com/mcp/sage-intacct-mcp-by-superglue): Sage Intacct MCP by superglue is an MCP server for finance and payments.
- [FacturaSmart Pro](https://ai-powered.com/mcp/facturasmart-pro): FacturaSmart Pro is an MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/superbooks
