Skip to content
MCP server

Quarterwise MCP by usefulapi

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

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About Quarterwise MCP by usefulapi

Quarterwise MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://quarterwise.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "quarterwise": {
      "url": "https://quarterwise.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Read directly from the server.

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.

Quarterwise MCP by usefulapi 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