# Spruce Health MCP by usefulapi

> Spruce Health MCP by usefulapi is an MCP server for health and science. Read Spruce Health contacts, conversations, messages, phone lines and team members (read-only). It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read Spruce Health contacts, conversations, messages, phone lines and team members (read-only).

## Install

### Claude Code (Terminal)

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

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

```sh
https://spruce-health.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "spruce-health": {
      "url": "https://spruce-health.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "spruce-health": {
      "serverUrl": "https://spruce-health.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `sprucehealth_get_organization`: Your Spruce organization (id and name). The id is the owner/member id used by other objects. Good first call. GET /organization.
- `sprucehealth_list_members`: All members of the organization: teammates (name, email, admin, suspended), teams and the organization itself. Paged with hasMore/paginationToken; totalCount included. GET /organization/members.
- `sprucehealth_get_member`: One organization member (teammate, team or the organization) by id. GET /organization/members/{memberId}.
- `sprucehealth_list_team_members`: The members of one team (team ids come from sprucehealth_list_members, type 'team'). Paged. GET /teams/{teamId}/members.
- `sprucehealth_list_contacts`: Contacts of the organization (patients, professionals, clinics): name, date of birth, phones, emails, tags, custom fields, integration links. Paged with hasMore/paginationToken; totalCount included. Use sprucehealth_search_contacts to find someone. GET /contacts.
- `sprucehealth_search_contacts`: Find contacts by free text and/or filters (category, tags, name, phone, email, invite state, created time). Filters combine with AND; values inside one filter match ANY (tags can use all/none). Paged; totalCount with totalCountRelation (eq = exact, gte = lower bound). A read: POST /contacts/search changes nothing.
- `sprucehealth_get_contact`: One contact by Spruce contact id (entity_…): demographics, phones, emails, tags, custom and organization fields, integration links. GET /contacts/{contactId}.
- `sprucehealth_list_contact_conversations`: The conversations (secure, SMS/phone, email, fax…) associated with one contact. GET /contacts/{contactId}/conversations.
- `sprucehealth_list_contact_integration_links`: Links between a contact and external systems (Elation, Hint, athena, custom): type, external id, url. GET /contacts/{contactId}/integrationlinks.
- `sprucehealth_list_contact_tags`: All contact tags of the organization. Paged with hasMore/paginationToken; totalCount included. GET /contacts/tags.
- `sprucehealth_list_contact_fields`: The organization-wide contact fields shown on every contact. Paged; totalCount included. GET /contacts/fields.
- `sprucehealth_list_conversations`: Conversations of the organization (title, type, tags, archived, assignee, participants, last message time), ordered by creation or last message. With start_from, only conversations whose ordering time is at or after it (useful for 'what changed since…'). Eventually consistent. Paged; give start_from OR pagination_token, not both. GET /conversations.
- `sprucehealth_get_conversation`: One conversation by id (t_…). GET /conversations/{conversationId}.
- `sprucehealth_list_conversation_items`: The items (messages, internal notes, calls, voicemails, faxes, attachments with short-lived signed URLs) in one conversation. Order newest_first (default) or oldest_first; start_from = only items created after that time. Paged with hasMore/paginationToken; totalCount is a best-effort count. GET /conversations/{conversationId}/items.
- `sprucehealth_get_conversation_item`: One conversation item (message, note, call, voicemail…) by id (ti_…). GET /conversationItems/{conversationItemId}.
- `sprucehealth_list_read_receipts`: Who has read one conversation item and when they first read it (oldest first). GET /conversationItems/{conversationItemId}/readReceipts.
- `sprucehealth_get_transcription`: The full transcription text and its summary (if any) for a transcription id (the transcriptionId on a call/voicemail attachment). Status pending/completed/failed/noSpeech. GET /transcriptions/{transcriptionId}.
- `sprucehealth_list_conversation_tags`: All conversation tags of the organization. Paged; totalCount included. GET /conversations/tags.
- `sprucehealth_list_conversation_scheduled_messages`: Messages scheduled to be sent later in one conversation (read only; nothing is sent or cancelled). GET /conversations/{conversationId}/scheduledmessages.
- `sprucehealth_list_scheduled_messages`: All messages scheduled to be sent from the organization (read only). Paged with hasMore/paginationToken; totalCount included. GET /scheduledmessages.
- `sprucehealth_list_saved_messages`: Saved message templates (private and organization-wide): title, text, internal/shared flags. Paged with hasMore/paginationToken. GET /savedmessages.
- `sprucehealth_list_internal_endpoints`: The organization's own channels: Spruce phone and fax numbers, email addresses and Spruce Links, with their owner and members. GET /internalendpoints.
- `sprucehealth_list_phone_lines`: All phone lines of the organization (id, name); totalCount included. GET /phonelines.
- `sprucehealth_get_phone_line`: One phone line by id (pd_…). GET /phonelines/{phonelineId}.

## FAQ

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

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

### What are the best alternatives to Spruce Health MCP by usefulapi?

The closest alternatives to Spruce Health MCP by usefulapi are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

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