Skip to main content
Glama
babybuddy-mcp

babybuddy-mcp

Official
by babybuddy

babybuddy-mcp

An MCP server for the Baby Buddy baby tracking application. Connect AI assistants to your babybuddy instance to log and query feedings, sleep, diaper changes, and more.

Built with FastMCP and designed to run alongside babybuddy in Docker.

Requirements

  • mise (for local development)

  • Python 3.13+

  • A running babybuddy instance with API access

Related MCP server: BabyBuddy MCP Server

Setup

1. Get your API token

  1. Log in to your babybuddy web UI

  2. Click your username in the top-right corner → Settings

  3. Copy the API Key shown on the page

2. Configure environment

cp .env.example .env

Edit .env:

BABYBUDDY_URL=http://localhost:8000   # URL of your babybuddy instance
BABYBUDDY_TOKEN=your-api-key-here     # Token from step 1
MCP_TRANSPORT=http                    # "http" for Docker, "stdio" for Claude Desktop
MCP_PORT=8080

Running with Docker

docker compose up --build

The MCP server will be available at http://localhost:8080/mcp/.

If babybuddy is running on the same Docker network, set BABYBUDDY_URL to use its service name (e.g. http://babybuddy:8000).

Connecting to Claude Desktop (stdio mode)

Set MCP_TRANSPORT=stdio in .env, then add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "babybuddy": {
      "command": "mise",
      "args": ["x", "python@3.13", "--", "uv", "run", "python", "-m", "babybuddy_mcp"],
      "cwd": "/path/to/babybuddy-mcp",
      "env": {
        "BABYBUDDY_URL": "http://localhost:8000",
        "BABYBUDDY_TOKEN": "your-api-key-here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Connecting via HTTP transport

Add to your MCP client config:

{
  "mcpServers": {
    "babybuddy": {
      "url": "http://localhost:8080/mcp/"
    }
  }
}

Available Tools

Tools are organized by domain with namespaced names (e.g. feedings_list_feedings).

Domain

Tools

children

list_children, get_child, create_child, update_child

diapers

list_diaper_changes, create_diaper_change, update_diaper_change, delete_diaper_change

feedings

list_feedings, create_feeding, update_feeding, delete_feeding

sleep

list_sleep, create_sleep, update_sleep, delete_sleep

pumping

list_pumping, create_pumping, update_pumping, delete_pumping

tummy_times

list_tummy_times, create_tummy_time, update_tummy_time, delete_tummy_time

timers

list_timers, get_timer, create_timer, update_timer, restart_timer, delete_timer

measurements

list/create/update/delete × bmi, height, weight, head_circumference, temperature

medications

list_medications, create_medication, update_medication, delete_medication

notes

list_notes, create_note, update_note, delete_note, list_tags, create_tag, update_tag, delete_tag

profile

get_profile

Most list_* tools accept tags and ordering filters where the Baby Buddy API supports them; create_note/update_note accept an image_path to attach an image. Children and tags are addressed by their slug (from list_children / list_tags), not numeric ID.

Environment Variables

Variable

Required

Default

Description

BABYBUDDY_URL

Yes

—

URL of your babybuddy instance

BABYBUDDY_TOKEN

Yes

—

API token from babybuddy Settings

MCP_TRANSPORT

No

http

Transport: http or stdio

MCP_HOST

No

0.0.0.0

Host to bind (HTTP transport only)

MCP_PORT

No

8080

Port to listen on (HTTP transport only)

REQUEST_TIMEOUT

No

30.0

Timeout in seconds for babybuddy API calls

DEFAULT_PAGE_SIZE

No

100

Max records returned per list call

Development

# Install tools and dependencies
mise install
mise run install

# Run tests
mise run test

# Lint
mise run lint

# Type check
mise run typecheck

Example prompts

  • "Log a feeding for Alice — she had breast milk from the left breast from 2pm to 2:25pm today"

  • "How many times did Alice eat yesterday?"

  • "Record a diaper change for Alice at 3pm — wet only"

  • "Start a sleep timer for Alice"

  • "Alice just woke up, end her sleep timer and log it"

  • "What was Alice's weight at her last checkup?"

Available Tools

63 tools
children_create_childA

Add a new child profile.

Inputs: last_name (required), birth_date (required), first_name (required), birth_time. Returns: object

children_get_childA

Get a single child profile by slug. Children are keyed by slug, not numeric ID.

Inputs: slug (required). Returns: object

children_list_childrenA

List child profiles. Always call this first to get child IDs and slugs needed by other tools.

Inputs: ordering, last_name, birth_date, first_name. Returns: result

children_update_childA

Update a child's profile by slug. Only provided fields are changed.

Inputs: slug (required), last_name, birth_date, birth_time, +1 more. Returns: object

diapers_create_diaper_changeA

Record a diaper change event.

Inputs: wet (required), time (required), solid (required), child_id (required), +3 more. Returns: object

diapers_delete_diaper_changeA

Delete a diaper change record. This action is permanent.

Inputs: change_id (required). Returns: result

diapers_list_diaper_changesC

List diaper change records with optional filters.

Inputs: wet, date, tags, color, +6 more. Returns: result

diapers_update_diaper_changeA

Update an existing diaper change record. Only provided fields are changed.

Inputs: change_id (required), wet, time, color, +3 more. Returns: object

feedings_create_feedingC

Record a feeding session.

Inputs: end (required), start (required), method (required), child_id (required), +4 more. Returns: object

feedings_delete_feedingA

Delete a feeding record. This action is permanent.

Inputs: feeding_id (required). Returns: result

feedings_list_feedingsB

List feeding records with optional filters.

Inputs: end, tags, limit, start, +8 more. Returns: result

feedings_update_feedingA

Update an existing feeding record. Only provided fields are changed.

Inputs: feeding_id (required), end, notes, start, +3 more. Returns: object

measurements_create_bmiC

Record a BMI measurement.

Inputs: bmi (required), date (required), child_id (required), notes. Returns: object

measurements_create_head_circumferenceB

Record a head circumference measurement.

Inputs: date (required), child_id (required), head_circumference (required), notes. Returns: object

measurements_create_heightC

Record a height measurement.

Inputs: date (required), height (required), child_id (required), notes. Returns: object

measurements_create_temperatureB

Record a temperature reading.

Inputs: time (required), child_id (required), temperature (required), notes. Returns: object

measurements_create_weightC

Record a weight measurement.

Inputs: date (required), weight (required), child_id (required), notes. Returns: object

measurements_delete_bmiB

Delete a BMI record. This action is permanent.

Inputs: bmi_id (required). Returns: result

measurements_delete_head_circumferenceA

Delete a head circumference record. This action is permanent.

Inputs: head_circumference_id (required). Returns: result

measurements_delete_heightA

Delete a height record. This action is permanent.

Inputs: height_id (required). Returns: result

measurements_delete_temperatureB

Delete a temperature record. This action is permanent.

Inputs: temperature_id (required). Returns: result

measurements_delete_weightA

Delete a weight record. This action is permanent.

Inputs: weight_id (required). Returns: result

measurements_list_bmiC

List BMI measurements.

Inputs: date, limit, child_id, ordering. Returns: result

measurements_list_head_circumferenceC

List head circumference measurements.

Inputs: date, limit, child_id, ordering. Returns: result

measurements_list_heightC

List height measurements.

Inputs: date, limit, child_id, ordering. Returns: result

measurements_list_temperatureC

List temperature readings.

Inputs: date, tags, limit, child_id, +3 more. Returns: result

measurements_list_weightC

List weight measurements.

Inputs: date, limit, child_id, ordering. Returns: result

measurements_update_bmiA

Update an existing BMI record. Only provided fields are changed.

Inputs: bmi_id (required), bmi, date, notes. Returns: object

measurements_update_head_circumferenceA

Update an existing head circumference record. Only provided fields are changed.

Inputs: head_circumference_id (required), date, notes, head_circumference. Returns: object

measurements_update_heightA

Update an existing height record. Only provided fields are changed.

Inputs: height_id (required), date, notes, height. Returns: object

measurements_update_temperatureA

Update an existing temperature record. Only provided fields are changed.

Inputs: temperature_id (required), time, notes, temperature. Returns: object

measurements_update_weightA

Update an existing weight record. Only provided fields are changed.

Inputs: weight_id (required), date, notes, weight. Returns: object

medications_create_medicationB

Record a medication administration for a child.

Inputs: name (required), child_id (required), tags, time, +4 more. Returns: object

medications_delete_medicationA

Delete a medication record. This action is permanent.

Inputs: medication_id (required). Returns: result

medications_list_medicationsB

List medication administration records with optional filters.

Inputs: date, name, tags, limit, +5 more. Returns: result

medications_update_medicationA

Update an existing medication record. Only provided fields are changed.

Inputs: medication_id (required), name, tags, time, +4 more. Returns: object

notes_create_noteA

Create a new note for a child. Optionally attach an image.

Inputs: note (required), time (required), child_id (required), tags, +1 more. Returns: object

notes_create_tagC

Create a new tag.

Inputs: name (required), color. Returns: object

notes_delete_noteA

Delete a note. This action is permanent.

Inputs: note_id (required). Returns: result

notes_delete_tagA

Delete a tag by slug. This action is permanent and removes the tag from all notes.

Inputs: slug (required). Returns: result

notes_list_notesB

List notes with optional filters.

Inputs: date, tags, limit, child_id, +3 more. Returns: result

notes_list_tagsA

List all available tags that can be applied to notes.

Inputs: no named parameters. Returns: result

notes_update_noteA

Update an existing note. Only provided fields are changed.

Inputs: note_id (required), note, tags, time, +1 more. Returns: object

notes_update_tagB

Update an existing tag by slug. Tags are keyed by slug, not numeric ID.

Inputs: slug (required), name, color. Returns: object

profile_get_profileA

Get the current authenticated user's profile: user details, language, timezone, and API key.

Inputs: no named parameters. Returns: object

pumping_create_pumpingB

Record a pumping session.

Inputs: end (required), start (required), child_id (required), notes, +2 more. Returns: object

pumping_delete_pumpingA

Delete a pumping record. This action is permanent.

Inputs: pumping_id (required). Returns: result

pumping_list_pumpingC

List pumping session records with optional filters.

Inputs: end, limit, start, end_max, +5 more. Returns: result

pumping_update_pumpingB

Update an existing pumping record. Only provided fields are changed.

Inputs: pumping_id (required), end, notes, start, +1 more. Returns: object

sleep_create_sleepB

Record a sleep session.

Inputs: end (required), start (required), child_id (required), nap, +2 more. Returns: object

sleep_delete_sleepA

Delete a sleep record. This action is permanent.

Inputs: sleep_id (required). Returns: result

sleep_list_sleepA

List sleep records with optional filters.

Inputs: end, tags, limit, start, +6 more. Returns: result

sleep_update_sleepA

Update an existing sleep record. Only provided fields are changed.

Inputs: sleep_id (required), end, nap, notes, +1 more. Returns: object

timers_create_timerA

Start a new timer. Use the returned ID when finishing a feeding, sleep, pumping, or tummy time session.

Inputs: name, child_id. Returns: object

timers_delete_timerA

Stop and delete a timer. Use create_feeding/create_sleep/etc. with timer_id first to log the session.

Inputs: timer_id (required). Returns: result

timers_get_timerA

Get a specific timer to see its name, start time, and elapsed duration.

Inputs: timer_id (required). Returns: object

timers_list_timersA

List active and recent timers. Use timer IDs when creating feedings, sleep, pumping, or tummy time records.

Inputs: name, child_id, ordering. Returns: result

timers_restart_timerA

Restart a timer, resetting its start time to now while keeping the same timer.

Inputs: timer_id (required). Returns: object

timers_update_timerB

Update a timer's name or child association.

Inputs: timer_id (required), name, child_id. Returns: object

tummy_times_create_tummy_timeC

Record a tummy time session.

Inputs: end (required), start (required), child_id (required), notes, +2 more. Returns: object

tummy_times_delete_tummy_timeA

Delete a tummy time record. This action is permanent.

Inputs: tummy_time_id (required). Returns: result

tummy_times_list_tummy_timesA

List tummy time session records with optional filters.

Inputs: end, tags, limit, start, +6 more. Returns: result

tummy_times_update_tummy_timeA

Update an existing tummy time record. Only provided fields are changed.

Inputs: tummy_time_id (required), end, notes, start, +1 more. Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 63 tools

    Disambiguation5/5

    Every tool targets a unique resource-action pair, such as feedings_create_feeding vs pumping_create_pumping. Even the many measurement types are clearly separated by their specific noun (bmi, height, weight, head_circumference, temperature), leaving no ambiguity between tools.

    Naming Consistency5/5

    Tools follow a consistent <domain>_<verb>_<entity> pattern, with domains consistently pluralized (feedings_, measurements_, etc.) and entity names switching between singular and plural only as grammatical context demands. The pattern is uniform and predictable across all 63 tools.

    Tool Count1/5

    With 63 tools, the count far exceeds the 50+ threshold defined as an extreme mismatch. While each tool serves a clear purpose, the sheer number makes the toolset unwieldy, likely overwhelming agents with context and selection overhead. The scope could be split into multiple focused servers.

    Completeness4/5

    The toolset covers all major Baby Buddy resources—children, feedings, pumping, diapers, sleep, tummy time, measurements, notes, tags, medications, timers, and profile—with full CRUD on most entities. The only notable gap is the absence of a child delete operation, and many records lack individual getters, though list-with-filters compensates for that.

    Maintenance

    ActivitySlowing
    ResponsivenessLimited data

    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
      Not graded
      quality
      D
      maintenance
      Integrates with self-hosted BabyBuddy to log and retrieve baby care data such as feedings, sleep, diaper changes, and measurements via natural language.
      4
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants such as Claude, ChatGPT and Gemini to read wearable health data — daily activity, sleep stages, heart rate, SpO2, HRV, workouts, weight and nutrition — through a self-hosted, OAuth-protected Cloudflare Worker endpoint. It also lets users log weight, body fat, water, food, exercises, mood and symptoms by voice or chat, while leaving sensor-recorded data read-only.
      MIT