MCP server · AI assistant

Ask Claude how Mum's week has been.

Install the open-source Getwello MCP server in Claude Desktop. Claude can then answer real questions about your Circle, post in the Family Room and read upcoming visits. Without you ever opening the Getwello app.

Setup guide Get an API key

Coordinator-only. Included in the £4.99 plan. Same day to set up.

Claude Desktop

How has Mum's week been?

Looking at the last 7 days from Getwello:

✓ Six of seven check-ins on time, average 08:17
✓ Mood “fine” or “great” every day except Thursday (“a bit low”)
✓ James visited Tuesday, Chloe visited Friday
✓ One missed day (Sat 11 May), caught up at 11:42

The Thursday dip lines up with the GP appointment. Worth checking in with her about that.

get_circle_statslist_gap_days

MCP tool call

get_circle_stats

Returned summary in 180ms

Why this one's different

Conversational care, on the laptop you already use.

Ask in natural language

No menus, no taps, no recall of where the data lives. Type the question the way you'd ask a sibling.

You bring your own Claude

We do not pay for AI tokens. Your existing Claude Pro or Team subscription does the work, Getwello is free on top.

Open source MCP server

Audit it, fork it, run it offline. Published as @getwello-app/mcp-server on npm. The same package we use ourselves.

Same safety gates as the app

Subscription lapse, role demotion, key revocation: Claude loses access the moment any of these happen. No exceptions.

{
  "mcpServers": {
    "getwello": {
      "command": "npx",
      "args": ["-y", "@getwello-app/mcp-server"],
      "env": {
        "GETWELLO_API_KEY": "gw_live_..."
      }
    }
  }
}

What it actually looks like

One claude.json line. One restart. Live.

The MCP server is a tiny program that lets Claude call our REST API on your behalf. The whole install is pasting a JSON snippet into your Claude Desktop config, dropping in your API key and restarting Claude. Done.

Install via npx, no global packages or build steps.
API key lives in the env block, not in plain text on disk.
Sixteen tools: reads across check-ins, visits, mood, places, notifications and subscription. Writes for scheduling and cancelling visits, posting and retracting Family Room messages. One aggregate (get_circle_stats) that answers broad questions in a single call.
Same gates as the REST API: Coordinator-only, subscription-gated, revocable. Write tools are scoped to the calling user (cannot schedule on behalf of others, cannot delete human messages).

How to set it up

The high level. Full walkthrough in the help guide.

01
Step 1 of 4
Mint a Getwello API key.
Open Settings → Developer API as a Coordinator. Name the key 'Claude Desktop on my MacBook'. Copy the gw_live_ token (shown once).
02
Step 2 of 4
Open your Claude Desktop config.
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%/Claude/claude_desktop_config.json. Create if it doesn't exist.

Step 3 of 4

Add the Getwello MCP server.

Paste the snippet, drop your API key into the env var, save.

config

{
  "mcpServers": {
    "getwello": {
      "command": "npx",
      "args": ["-y", "@getwello-app/mcp-server"],
      "env": { "GETWELLO_API_KEY": "gw_live_..." }
    }
  }
}

04
Step 4 of 4
Restart Claude and ask it something.
Fully quit (Cmd-Q), reopen, ask 'list my Getwello Circles'. If the list comes back, you're wired up. Try 'how has Mum's week been?' next.

Read the Claude Desktop setup guide →Mint your API key

Frequently asked questions

Does this work with Claude on the web (claude.ai)?

Not directly. MCP servers run locally and require a desktop app that supports the protocol. Claude Desktop, Cursor and VS Code MCP extensions are the main supported clients in 2026. Anthropic has said web support is coming.

Does it work with Cursor or other MCP clients?

Yes. The setup is identical, just edit Cursor's config (typically ~/.cursor/mcp.json) instead of Claude's. The MCP protocol is standardised, so any compliant client can use the server.

Does this work with a local Ollama model?

Yes, if your local LLM client supports MCP. Open WebUI, LM Studio and a few others have MCP support landing in 2026. The Getwello server itself does not care which AI calls it.

Can Claude tap 'I'm well' on behalf of Mum?

No, deliberately. The check-in is a human emotional act. Claude can read check-ins, post in the Family Room, schedule visits, ask the family to ring, but never tap 'I'm well' on someone's behalf. The same restriction applies to every integration we publish.

Does Anthropic see my Circle data?

Whatever you ask Claude reaches Anthropic's servers as part of the conversation context. If that is a concern, run a local model via Ollama or LM Studio with MCP support instead. Getwello itself never sends your data anywhere except in response to your authenticated API calls.

Other integrations

Pair this with another.

Some families wire two or three at the same time. The webhook fans out, the API keys stay the same.

See every integration or jump to the Developer API overview.

Connect Getwello to Claude Desktop.
Today.

Mint your first API key in two minutes. Coordinator-only. Included in the £4.99 family plan.

Start your free month →

£0 todayFirst month on usCancel any time, in one tap