# Quarterwise MCP by usefulapi

> Quarterwise MCP by usefulapi is an MCP server. Read properties, HMRC categories and transactions; add income and expenses in Quarterwise. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/quarterwise/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/quarterwise
- **MCP Registry name:** io.usefulapi/quarterwise
- **Listing updated:** 2026-11-13

## About

Read properties, HMRC categories and transactions; add income and expenses in Quarterwise.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `quarterwise_get_account`: Show which Quarterwise account the key belongs to, its plan (free, pro, expat, firm) and what the API can do. HMRC submission is always false: filing is done in the app. API: GET /api/v1/me.
- `quarterwise_list_sources`: List the income sources on the account: UK properties, overseas properties and self-employment businesses, with id, type, share percent, role (owner or sharer) and transaction count. The id is the input of the transaction tools. API: GET /api/v1/sources.
- `quarterwise_list_categories`: List the valid income and expense category keys (HMRC field names) per source type. Keys differ by type, so check them before adding transactions. API: GET /api/v1/categories.
- `quarterwise_list_transactions`: List income and expense entries of one property or business, optionally in a date range. Amounts are in pence. Returns nextCursor: pass it as cursor to get the next page. API: GET /api/v1/sources/{id}/transactions.
- `quarterwise_add_transactions`: WRITE: add 1 to 100 income or expense entries to a property or business ledger. Each entry needs a unique externalRef: re-posting the same ref adds nothing, so a retry is safe. Entries without a category go to the review queue in the app. Never submits anything to HMRC. API: POST /api/v1/sources/{id}/transactions.

## FAQ

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

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

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