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.
概览
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. - mise (for local development) - Python 3.13+ - A running babybuddy instance with API access 1. Log in to your babybuddy web UI 2. Click your username in the top-right corner → 3. Copy the shown on the page 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). Set MCP_TRANSPORT=stdio in .env, then add to your Claude Desktop claude_desktop_config.json: Tools are organized by domain with namespaced names (e.g. feedings_list_feedings).
README
以下为原文 README 节选，完整内容请查看原文。
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
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 .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", "[email protected]", "--", "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 |
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"babybuddy": {
"command": "mise",
"args": ["x", "[email protected]", "--", "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"
}
}
}
}