# Run my Accounts MCP by usefulapi

> Run my Accounts MCP by usefulapi is an MCP server. Read customers, invoices, vendor bills, trial balance and ledger transactions in Run my Accounts. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read customers, invoices, vendor bills, trial balance and ledger transactions in Run my Accounts.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http run-my-accounts https://run-my-accounts.usefulapi.io/mcp
```

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

```sh
https://run-my-accounts.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "run-my-accounts": {
      "url": "https://run-my-accounts.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "run-my-accounts": {
      "type": "http",
      "url": "https://run-my-accounts.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "run-my-accounts": {
      "serverUrl": "https://run-my-accounts.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "run-my-accounts": {
      "type": "http",
      "url": "https://run-my-accounts.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `runmyaccounts_list_customers`: List all customers (debtors) with number, name, address, contact and bank data. API: GET /customers.
- `runmyaccounts_get_customer`: Get one customer by customer number. API: GET /customers/{customernumber}.
- `runmyaccounts_list_invoices`: List customer invoices. Filter by status (OPEN, PAID, OVERDUE), date range and customer number. API: GET /invoices.
- `runmyaccounts_get_invoice`: Get one customer invoice with its customer and line items. API: GET /invoices/{invoice_number}.
- `runmyaccounts_list_invoice_payments`: List the payments booked against one customer invoice. API: GET /invoices/{invoice_number}/payments.
- `runmyaccounts_list_payments_since`: List incoming invoice payments that were not marked as processed after a time stamp. This tool only reads: it never marks a payment as processed. API: GET /invoices/payment_list?processed=.
- `runmyaccounts_list_parts`: List parts (articles) with number, description, unit, price and account numbers. API: GET /parts.
- `runmyaccounts_list_vendors`: List vendors (creditors). Sort by id, name, vendornumber or score (add asc or desc) and search by name. API: GET /vendors.
- `runmyaccounts_list_vendor_invoices`: List vendor invoices (payables) with status, amounts, paid amount and vendor. API: GET /payables.
- `runmyaccounts_get_vendor_invoice`: Get one vendor invoice by invoice number. API: GET /payables/{invoice_number}.
- `runmyaccounts_list_vendor_invoice_payments`: List the payments booked against one vendor invoice. API: GET /payables/{invoice_number}/payments.
- `runmyaccounts_list_charts`: List the chart of accounts. Optionally filter by account type. API: GET /charts.
- `runmyaccounts_trial_balance`: Get account balances (trial balance, version 2). Use x as a wildcard in accno (15xx = 1500 to 1599). Income statement accounts need from and to. API: GET /gl/v2/saldo.
- `runmyaccounts_list_account_transactions`: List ledger transactions of one account or a wildcard pattern (x matches any digit, use x for all accounts). API: GET /charts/{accno}/transactions.
- `runmyaccounts_list_departments`: List departments (cost and profit centers). API: GET /departments.
- `runmyaccounts_list_projects`: List projects. API: GET /projects.

## FAQ

### How do I add Run my Accounts MCP by usefulapi to Claude Code?

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

---
Source: https://ai-powered.com/mcp/run-my-accounts-mcp-by-usefulapi
