Install, uninstall, and manage Betterness MCP server integrations for AI clients (Claude, Cursor, Windsurf).
Install, uninstall, and manage Betterness MCP server integrations for AI clients (Claude, Cursor, Windsurf).
npx skills add https://github.com/Betterness/betterness-cli --skill betterness-mcp复制此命令并粘贴到 Claude Code 中以安装该技能
Browse and search available lab tests with prices and included markers.
Search the Betterness knowledge library — files and videos via OpenSearch full-text search.
Manage authentication — OAuth login, API key login, logout, and verify identity.
Read, update, and explore the user's health profile questionnaire (sections, questions, answers).
Shared reference: auth, global flags, output formats, and security rules for the Betterness CLI.
Biomarker lab results, LOINC codes, and biological age calculations.
| name | betterness-mcp |
| version | 1.0.0 |
| description | Install, uninstall, and manage Betterness MCP server integrations for AI clients (Claude, Cursor, Windsurf). |
| metadata | {"category":"service","requires":{"bins":["betterness"]}} |
PREREQUISITE: Read
../betterness-shared/SKILL.mdfor auth, global flags, and security rules.
betterness mcp <command> [flags]
One-command setup for the Betterness MCP server integration. Writes the correct config to the correct file for each AI client, using stored credentials.
Supported clients: claude (Claude Desktop), claude-code, cursor, windsurf.
mcp installInstall Betterness MCP into an AI client's config file.
# Install for Claude Desktop
betterness mcp install claude
# Install for Claude Code (global scope, default)
betterness mcp install claude-code
# Install for Claude Code (project scope — writes .mcp.json in cwd)
betterness mcp install claude-code --scope project
# Install for Cursor
betterness mcp install cursor
# Preview without writing
betterness mcp install claude --dry-run
| Option | Description |
|---|---|
<client> | Required. Target client: claude, claude-code, cursor, windsurf |
--scope <scope> | global or project (claude-code only, default: global) |
--dry-run | Print the config that would be written without making changes |
What it does:
mcpServers.betterness entry, preserving all other config<filename>.bakReturns: client, configFile, status, apiKey (truncated), backup
mcp uninstallRemove the Betterness entry from a client's MCP config.
betterness mcp uninstall claude
betterness mcp uninstall claude-code --scope project
| Option | Description |
|---|---|
<client> | Required. Target client to unconfigure |
--scope <scope> | global or project (claude-code only, default: global) |
Does not revoke the API key — use betterness auth logout for that.
mcp statusShow which AI clients have Betterness MCP configured.
betterness mcp status --json
Scans all known config file paths and reports:
mcpServers.betterness entry| Client | macOS | Linux |
|---|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | ~/.config/Claude/claude_desktop_config.json |
| Claude Code (global) | ~/.claude/settings.json | ~/.claude/settings.json |
| Claude Code (project) | .mcp.json in project root | .mcp.json in project root |
| Cursor | .cursor/mcp.json in project root | .cursor/mcp.json in project root |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | ~/.codeium/windsurf/mcp_config.json |
mcp install after auth login — it reuses the same credentials.--dry-run to inspect the config before writing, especially if the client already has other MCP servers configured.mcp status --json to programmatically check integration state across all clients.