babylitics-mcp

MCP (Model Context Protocol) server for Babylitics — connect AI agents to your baby tracking data.

Installation

npx babylitics-mcp

Setup

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "babylitics": {
      "command": "npx",
      "args": ["babylitics-mcp"]
    }
  }
}

Claude Code

claude mcp add babylitics -- npx babylitics-mcp

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "babylitics": {
      "command": "npx",
      "args": ["babylitics-mcp"]
    }
  }
}

Authorization

On first use, the agent will ask you to authorize via your browser:

🔐 Authentication required to access Babylitics.

Please visit: https://api.babylitics.io/oauth/device Enter this code: ABCD-1234

Once you've approved access, try your request again.

Tokens are cached locally at ~/.babylitics/tokens.json and refresh automatically. You only need to re-authorize when the refresh token expires (after 30 days).

Available Tools

Read Tools (always available)

| Tool | Description | |------|-------------| | list_babies | List all tracked babies | | get_dashboard | Dashboard summary for a baby (defaults to today, pass date for past days) | | get_feedings | Feeding records with optional date or start_date/end_date filter | | get_feeding_stats | Feeding statistics and averages with optional date filter | | get_feeding_vs_guideline | Compare feeding intake against age-appropriate guidelines | | get_sleeps | Sleep records with optional date range filter | | get_sleep_stats | Sleep statistics with optional date or start_date/end_date filter | | get_sleep_vs_guideline | Compare sleep against age-appropriate guidelines | | get_weights | Weight records with optional date range filter | | get_weight_stats | Weight statistics (current, birth, gain, growth velocity) | | get_weight_vs_guideline | Weight compared to WHO growth standards | | get_lengths | Length/height records with optional date range filter | | get_length_stats | Length statistics (current, birth, growth, velocity) | | get_length_vs_guideline | Length compared to WHO growth standards | | get_temperatures | Temperature records with optional date range filter | | get_temperature_stats | Temperature statistics (current, average, highest, fever status) | | get_temperature_guidelines | AAP fever/hypothermia thresholds by age range | | get_diapers | Diaper change records with optional date or start_date/end_date filter |

Write Tools (requires read:write scope)

| Tool | Description | |------|-------------| | log_feeding | Log a formula, breast, or solid feeding | | log_sleep | Log a nap or night sleep session | | log_weight | Log a weight measurement | | log_length | Log a length/height measurement | | log_temperature | Log a temperature measurement | | log_diaper | Log a diaper change (wet, dirty, or mixed) |

Medical Guidelines

The guideline tools return evidence-based pediatric data from WHO and AAP sources. Agents can use these to compare a baby's actual data against age-appropriate recommendations.

| Tool | Source | Reference | |------|--------|-----------| | get_weight_vs_guideline | WHO | WHO Child Growth Standards | | get_length_vs_guideline | WHO | WHO Child Growth Standards | | get_feeding_vs_guideline | AAP/WHO/NHS | AAP Formula Feeding | | get_sleep_vs_guideline | AAP | AAP Sleep Recommendations | | get_temperature_guidelines | AAP | AAP Fever Guidelines | | get_diaper_guidelines | AAP | AAP Diaper Guidelines |

Disclaimer: These guidelines are for informational purposes only and should not replace professional medical advice.

Configuration

| Environment Variable | Default | Description | |---------------------|---------|-------------| | BABYLITICS_API_URL | https://api.babylitics.io | API base URL |

Development

npm install
npm run build
npm run dev    # watch mode
npm test

License

MIT