babybuddy-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@babybuddy-mcp Log a feeding for Alice: breast milk, left breast, 2pm to 2:25pm today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Log in to your babybuddy web UI
Click your username in the top-right corner → Settings
Copy the API Key shown on the page
2. Configure environment
cp .env.example .envEdit .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=8080Running with Docker
docker compose up --buildThe 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 |
|
diapers |
|
feedings |
|
sleep |
|
pumping |
|
tummy_times |
|
timers |
|
measurements |
|
medications |
|
notes |
|
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 |
| Yes | — | URL of your babybuddy instance |
| Yes | — | API token from babybuddy Settings |
| No |
| Transport: |
| No |
| Host to bind (HTTP transport only) |
| No |
| Port to listen on (HTTP transport only) |
| No |
| Timeout in seconds for babybuddy API calls |
| No |
| 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 typecheckExample 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 toolschildren_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
Scored across 63 tools
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.
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.
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.
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
Related MCP Connectors
Your Calori account in any AI assistant: nutrition targets, food logging, meal orders and deliveries
Connect your health, fitness, nutrition, sleep, and wearable data to your AI assistant.
Your Garmin, Oura, WHOOP, Hevy and 35 more fitness apps, queryable from your own AI.
Related MCP Servers
- AlicenseCqualityCmaintenanceHuckleberry MCP server for Claude, Cursor, and other AI assistants. Query and log baby sleep, feeds, diapers, growth, pumping, and solids.2913 npm1MIT
- AlicenseNot gradedqualityDmaintenanceIntegrates with self-hosted BabyBuddy to log and retrieve baby care data such as feedings, sleep, diaper changes, and measurements via natural language.4Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables interaction with Baby Daybook data through Firebase, allowing users to manage babies, activities, growth, sleep predictions, and more via natural language commands.23 npm2MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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