# ServiceMinder MCP by usefulapi

> ServiceMinder MCP by usefulapi is an MCP server. Find contacts, read appointments and invoices; add contacts, notes and tasks in ServiceMinder. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Find contacts, read appointments and invoices; add contacts, notes and tasks in ServiceMinder.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `serviceminder_locate_contacts`: Find contacts by name, phone, email, address, contact ID, tag or category. Needs a brand-scoped API key. Calls POST /api/contacts/locate.
- `serviceminder_query_appointments`: List appointments by date range, last change, contact or service agent. Pages with skip and take (max 500). Calls POST /api/appointments/query.
- `serviceminder_query_proposals`: List proposals by scope, date, acceptance date, owner or contact. The public docs do not list scope values, so pass the scope name your account uses. Calls POST /api/proposal/query.
- `serviceminder_get_proposal`: Get one proposal with its lines, status, totals and customer notes. Calls POST /api/proposal/details.
- `serviceminder_query_invoices`: List invoices by date range, last change or contact. Pages with skip and take (max 500). Calls POST /api/invoice/query.
- `serviceminder_get_invoice`: Get one invoice with its payments. Calls POST /api/invoice/get.
- `serviceminder_query_payments`: List payments by date range, contact or invoice. Pages with skip and take (max 500). Calls POST /api/payment/query.
- `serviceminder_list_services`: List the services of the organization, optionally with parts. Calls POST /api/services/all.
- `serviceminder_list_service_agents`: List the service agents (field staff) of the organization. Calls POST /api/serviceagents/all.
- `serviceminder_get_organization`: Get the details of an organization: its services, agents, users and custom fields. Calls POST /api/organizations/details.
- `serviceminder_query_tasks`: List follow-up tasks by due date, last change, contact or type. Pages with skip and take. Calls POST /api/task/query.
- `serviceminder_add_or_update_contact`: Add a lead or update a contact. Needs a name and a phone or an email. Custom fields use the names in your account. Calls POST /api/contacts/addupdate.
- `serviceminder_add_contact_note`: Add a note to a contact. Calls POST /api/contacts/addnote.
- `serviceminder_create_task`: Create a follow-up task for a contact. Calls POST /api/task/create.

## FAQ

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

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

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