Skip to main content
Glama
BabyBuddy MCP Server

BabyBuddy MCP Server

BabyBuddy MCP Server

MCP server for self-hosted BabyBuddy.

Transport: Streamable HTTP (runs on http://localhost:8080) Auth: Direct API Token via environment variables. No login required.


Quick Start

1. Install

cd babybuddy-mcp
pip install -r requirements.txt

2. Configure

Set the following environment variables in your .env file or shell:

Variable

Description

BABYBUDDY_INSTANCE

Your full BabyBuddy URL (e.g., https://your-instance.com/)

BABYBUDDY_TOKEN

Your API token (Settings → API → your token)

Optional:

Variable

Default

Description

HOST

localhost

Bind address

PORT

8080

Listen port

SERVER_URL

http://localhost:8080

Public base URL

3. Run

python3 server.py

Related MCP server: babybuddy-mcp

Tools (33 total)

Tool

Description

list_children

List all children (returns IDs needed by other tools)

log_feeding

Log a feeding — type, method, start/end, optional amount

get_feedings

Recent feedings for a child

delete_feeding

Delete a feeding session by ID

log_sleep

Log a sleep session (nap or night)

get_sleep

Recent sleep sessions

delete_sleep

Delete a sleep session by ID

log_diaper_change

Log a diaper change — wet, solid, color, amount

get_diaper_changes

Recent diaper changes

delete_diaper_change

Delete a diaper change by ID

log_temperature

Log temperature in °C

get_temperature

Recent temperature readings

delete_temperature

Delete a temperature reading by ID

log_weight

Log weight in kg

get_weight

Weight history

delete_weight

Delete a weight measurement by ID

log_height

Log height in cm

get_height

Height history

delete_height

Delete a height measurement by ID

log_head_circumference

Log head circumference in cm

get_head_circumference

Head circumference history

delete_head_circumference

Delete a head circumference measurement by ID

log_pumping

Log a pumping session in ml

get_pumping

Recent pumping sessions

delete_pumping

Delete a pumping session by ID

add_note

Add a free-text note

get_notes

Recent notes

delete_note

Delete a note by ID

get_timers

List active timers

start_timer

Start a new timer

stop_timer

Stop/delete a timer

get_tags

List all tags

get_daily_summary

All events for a child on a given day


Deploying to Google Cloud Run

The included Dockerfile targets Cloud Run.

Deploy to GCP

gcloud run deploy babybuddy-mcp \
  --source=. \
  --allow-unauthenticated \
  --set-env-vars="BABYBUDDY_INSTANCE=$BABYBUDDY_INSTANCE,BABYBUDDY_TOKEN=$BABYBUDDY_TOKEN"

Testing

To run the end-to-end tests against your real BabyBuddy instance:

  1. Ensure your .env file has BABYBUDDY_INSTANCE and BABYBUDDY_TOKEN set.

  2. Install test dependencies:

    uv pip install -r requirements.txt
  3. Run the tests:

    uv run pytest tests/test_e2e.py

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      Huckleberry MCP server for Claude, Cursor, and other AI assistants. Query and log baby sleep, feeds, diapers, growth, pumping, and solids.
      29
      13 npm
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Connect AI assistants to your Baby Buddy instance to log and query feedings, sleep, diaper changes, and more.
      63
      4
      BSD 2-Clause "Simplified"
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables read-only analysis of piyolog (baby care) data feed records, including feeding, sleep, and diaper logs. Allows integration with Claude Desktop and ChatGPT for querying and analyzing baby care data.
      MIT