# Mini Accountant — MCP setup

Connect your AI assistant to your [Mini Accountant](https://ad.miniaccountant.app)
workspace through our hosted **Model Context Protocol (MCP)** server. No local
setup, no API keys — the server is remote and protected by OAuth 2.1, so you sign
in once with your Mini Accountant account and your assistant acts on your behalf.

- **Server:** `mini-accountant`
- **Transport:** streamable HTTP
- **URL:** `https://mcp.miniaccountant.app/v1beta`
- **Auth:** OAuth 2.1 / OIDC (Authorization Code + PKCE) — you'll be prompted to sign in.
- **Sign-in required:** yes. The server is user-scoped, so there is a sign-in
  step and no anonymous access. It needs a Mini Accountant account, and every
  feature is free on iPhone, iPad, Android and the web. The optional Pro
  subscription removes the "Powered by Mini Accountant" line from invoices and
  reports; it does not unlock anything, so nothing the assistant can do here is
  behind it.
- **Built for:** freelancers and small businesses, including ones billing in
  more than one currency.

## What you can do

Once connected, the assistant can:

- **Invoices** — create, read, update, delete; add/update/remove positions and
  transactions; change the customer on an invoice.
- **Customers** — create, read, update, delete; set a customer's payment method.
- **Expenses** — create, read, update, delete; fetch expenses for a period.
- **Services** — manage your reusable product/service catalogue.
- **Payment settings** — manage the payment-method documents customers reference.
- **Analytics** — run reporting queries; get invoices/transactions/expenses for a
  date range; estimate tax for a period.
- **Account** — read and update your user profile and app settings.

Guided **skills** and **prompts** (e.g. "create an invoice") are also exposed so
the assistant discovers the right workflow automatically.

### Ask it things like

- *"Invoice Acme for 12 hours of design work at €90 an hour."*
- *"Log a €400 expense for the Berlin trip."*
- *"What did I invoice last month, and how much VAT is on it?"*
- *"Add a customer in the US who pays in dollars by bank transfer."*
- *"Which invoices have no payment against them yet?"*
- *"Estimate my tax for the third quarter."*

The assistant works in your own Mini Accountant workspace — the same data the
iOS, Android and web apps show.

## What it doesn't do

Worth stating plainly, because comparison tables tend to assume the opposite:

- **No recurring or scheduled invoicing.** You can duplicate an existing invoice
  in one step and the copy is dated today, which is the nearest equivalent.
- **No double-entry bookkeeping and no audit trail.** This is invoicing, expenses
  and reporting for a small business, not a general ledger.
- **No payroll.**
- **No statutory e-invoicing.** It does not file invoices into a national
  e-invoicing regime, and it does not produce an accountant-facing export in a
  national standard format.

---

## Install in Claude Code (plugin)

The quickest path — installs the remote server as a plugin, no manual config file.

```
/plugin marketplace add miniaccountant/mcp-setup
/plugin install mini-accountant@miniaccountant
/reload-plugins
```

Then run `/mcp` and complete the OAuth sign-in when prompted. That's it — the
`mini-accountant` tools are now available in your session.

> Prefer not to use the marketplace? Add the server directly:
> ```
> claude mcp add --transport http mini-accountant https://mcp.miniaccountant.app/v1beta
> ```

---

## Connect from other clients

Same remote URL, same OAuth sign-in — only the config location differs.

### Claude Desktop / claude.ai connectors

Add a **custom connector** pointing at the server URL:

1. Open **Settings → Connectors → Add custom connector** (claude.ai) or the
   equivalent in Claude Desktop.
2. Name: `Mini Accountant`
3. URL: `https://mcp.miniaccountant.app/v1beta`
4. Save, then connect and sign in with your Mini Accountant account when prompted.

### Cursor

Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):

```json
{
  "mcpServers": {
    "mini-accountant": {
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}
```

Reload Cursor, then authorize the server when Cursor opens the OAuth prompt.

### VS Code (GitHub Copilot / MCP) and other clients

Any client that supports remote/streamable-HTTP MCP servers works with the same
endpoint. Use the client's HTTP-server form:

```json
{
  "servers": {
    "mini-accountant": {
      "type": "http",
      "url": "https://mcp.miniaccountant.app/v1beta"
    }
  }
}
```

---

## Authentication

The server implements OAuth 2.1 / OpenID Connect with:

- Authorization Code grant + **PKCE (S256)**, refresh tokens.
- Dynamic Client Registration (RFC 7591) — clients register automatically.
- Discovery documents:
  - `https://mcp.miniaccountant.app/.well-known/oauth-authorization-server`
  - `https://mcp.miniaccountant.app/.well-known/oauth-protected-resource`
  - `https://mcp.miniaccountant.app/.well-known/openid-configuration`

Compliant MCP clients discover these automatically — you only need the server URL.
Tokens are issued to your account; the assistant can only see and change **your**
data.

---

## Troubleshooting

- **`401 Unauthorized` / prompted to sign in again** — the access token expired
  (1h TTL). Re-run the client's connect/authorize action.
- **Tools don't appear** — confirm the client finished the OAuth flow (in Claude
  Code, run `/mcp` and check the server shows *connected*).
- **Wrong workspace** — sign out of the connector and reconnect with the correct
  Mini Accountant account.

## Support

- Website: https://ad.miniaccountant.app
- Support: support@miniaccountant.app