Nestling

by kparmesar

193 downloads Not rated yet
GitHub

About

Nestling is an MCP server that lets you log and query your baby's daily routine. Feeds, sleep, nappy changes, and diary entries through natural conversation with Claude or any MCP-compatible AI assistant. Logged through the Nestling app for iOS and Android.

Explore

- CLI and library for reading and logging baby data
- MCP server for AI assistants (Claude, ChatGPT, etc.)
- Create-only writes – cannot update or delete entries
- Supports sleep, feed, nappy, and diary entries
- HTTP or stdio transport for MCP
- User-scoped authentication with Supabase Row Level Security

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Nestling
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Requirements

- Bun 1.3+ — the package ships TypeScript source with no build step, so it must be run on Bun (not Node).
- A Nestling account (Sign in with Google or Apple)
- A Nestling API token (generate one from the app: Settings → Data → API Token)

Install

From npm:

```bash
bun add -g nestling-ts

get_capabilities

Discovery: what data sources and tools are available

get_user

Account profile (email, user ID)

list_babies

Baby roster (`id` is passed to every other tool)

get_baby

Baby details (nickname, birth date, etc.)

list_sleep

Sleep sessions for a baby in a date range

list_feeds

Feeding entries (breast, bottle, solids) in a date range

list_nappies

Nappy/diaper entries in a date range

list_diary

Diary/journal entries in a date range

create_sleep

Log a new sleep session (start + end time)

create_feed

Log a new feed (breast, bottle, solids, expressing)

create_nappy

Log a new nappy/diaper change

create_diary

Log a new diary/journal entry

| Tool | Purpose |
| ------------------- | --------------------------------------------------------------------- |
| get_capabilities | Discovery: what data sources and tools are available |
| get_user | Account profile (email, user ID) |
| list_babies | Baby roster (id is passed to every other tool) |
| get_baby | Baby details (nickname, birth date, etc.) |
| list_sleep | Sleep sessions for a baby in a date range |
| list_feeds | Feeding entries (breast, bottle, solids) in a date range |
| list_nappies | Nappy/diaper entries in a date range |
| list_diary | Diary/journal entries in a date range |
| create_sleep | Log a new sleep session (start + end time) |
| create_feed | Log a new feed (breast, bottle, solids, expressing) |
| create_nappy | Log a new nappy/diaper change |
| create_diary | Log a new diary/journal entry |

Read tools return data; write tools create new entries (no update or delete).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "nestling": {
            "nestling": {
                "command": "bun",
                "args": [
                    "run",
                    "nestling-mcp"
                ],
                "cwd": "/absolute/path/to/nestling-ts",
                "env": {
                    "NESTLING_API_TOKEN": "your-token-from-nestling-app",
                    "NESTLING_TIMEZONE": "Europe/London"
                }
            }
        }
    }
}

McpServers

{
    "nestling": {
        "command": "bun",
        "args": [
            "run",
            "nestling-mcp"
        ],
        "cwd": "/absolute/path/to/nestling-ts",
        "env": {
            "NESTLING_API_TOKEN": "your-token-from-nestling-app",
            "NESTLING_TIMEZONE": "Europe/London"
        }
    }
}

TypeScript client, CLI, and MCP server for the Nestling baby tracking app. Read and log sleep, feed, nappy, and diary data from your Nestling account — from your terminal, a TypeScript/Bun library, or via a Model Context Protocol server for Claude, ChatGPT, and other AI assistants.

> Create-only writes. The API can log new entries that sync to your app. It cannot update or delete existing entries — your data is always safe.

Requirements

- Bun 1.3+ — the package ships TypeScript source with no build step, so it must be run on Bun (not Node).
- A Nestling account (Sign in with Google or Apple)
- A Nestling API token (generate one from the app: Settings → Data → API Token)

Install

From npm:

```bash
bun add -g nestling-ts

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.