Skip to content
MCP server

PetKit

Unofficial server to check and control PetKit Fresh Element Solo feeders

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
0.4.0
Listing updated
today

Similar MCP servers

About PetKit

PetKit is a free MCP server for pets. It runs locally on your machine and is started by your AI client.

This community project talks to the reverse-engineered PetKit cloud API to expose Fresh Element Solo feeders (device type D4). The README is clear that it is not affiliated with PetKit, and that the API may change or break without notice. It runs locally over stdio through npx and needs your PetKit email, password and exact region name, with an optional timezone.

The interesting detail is how much it reports. list_feeders shows food, battery and desiccant status, lock, light and sound settings, today's totals, today's scheduled meals, and a log of dispenses that actually completed. It compares the time a dispense really happened with the feeder's own clock and derives an offset, which can reveal a feeder that missed the daylight-saving switch. Feed totals are per device, not per cat, because PetKit cannot attribute a dispense to a pet.

The D4 accepts only portions of 10, 20, 30, 40 or 50. A single-user HTTP mode with OAuth and an owner passphrase lets claude.ai reach it, and Docker images cover amd64, arm64 and arm/v7.

Install

Run in a terminal

claude mcp add mcp-server-petkit --env PETKIT_EMAIL='<PETKIT_EMAIL>' --env PETKIT_PASSWORD='<PETKIT_PASSWORD>' --env PETKIT_REGION='<PETKIT_REGION>' -- npx -y mcp-server-petkit

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-petkit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-petkit"
      ],
      "env": {
        "PETKIT_EMAIL": "<PETKIT_EMAIL>",
        "PETKIT_PASSWORD": "<PETKIT_PASSWORD>",
        "PETKIT_REGION": "<PETKIT_REGION>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-petkit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-petkit"
      ],
      "env": {
        "PETKIT_EMAIL": "<PETKIT_EMAIL>",
        "PETKIT_PASSWORD": "<PETKIT_PASSWORD>",
        "PETKIT_REGION": "<PETKIT_REGION>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server-petkit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-petkit"
      ],
      "env": {
        "PETKIT_EMAIL": "<PETKIT_EMAIL>",
        "PETKIT_PASSWORD": "<PETKIT_PASSWORD>",
        "PETKIT_REGION": "<PETKIT_REGION>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-petkit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-petkit"
      ],
      "env": {
        "PETKIT_EMAIL": "<PETKIT_EMAIL>",
        "PETKIT_PASSWORD": "<PETKIT_PASSWORD>",
        "PETKIT_REGION": "<PETKIT_REGION>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server-petkit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-petkit"
      ],
      "env": {
        "PETKIT_EMAIL": "<PETKIT_EMAIL>",
        "PETKIT_PASSWORD": "<PETKIT_PASSWORD>",
        "PETKIT_REGION": "<PETKIT_REGION>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PETKIT_EMAILEmail address of your PetKit accountRequired
  • PETKIT_PASSWORDPassword of your PetKit accountRequired
  • PETKIT_REGIONRegion name exactly as shown in the PetKit app (e.g. "Netherlands", "United States")Required
  • PETKIT_TIMEZONEIANA timezone (e.g. "Europe/Amsterdam"); defaults to the host's timezone

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

list_feeders
List feeders with live state, today's plan and dispense log.
feed_now
Dispense food immediately.
update_feeder_setting
Change a numeric feeder setting.
skip_scheduled_feed
Skip one of today's scheduled meals.
restore_scheduled_feed
Undo a skipped meal for today.

What it does

Feeder status
Reads food, battery and desiccant status plus lock, light and sound settings.
Dispense log
Lists completed dispenses today with a clock-offset check.
Manual feeding
Dispenses food immediately in the five supported portion sizes.
Skip and restore meals
Skips one of today's scheduled meals without changing the recurring plan.
Setting changes
Updates numeric settings such as child lock and shortage alarm.
Remote connector mode
HTTP mode with OAuth lets claude.ai connect via a tunnel.

Good for

  • Ask whether the cat's feeder is low on food or battery
  • Skip tonight's scheduled meal from a chat
  • Give a quick extra portion remotely
  • Spot a feeder clock that is an hour off after a time change

Pricing

Free

Free community package

PetKit FAQ

Is it official?

No. It is an independent community project and uses an unofficial, reverse-engineered API.

Which feeder works?

The Fresh Element Solo, device type D4.

What credentials does it need?

PETKIT_EMAIL, PETKIT_PASSWORD and PETKIT_REGION, with an optional timezone.

Why does login fail with a long password?

PetKit passwords are capped at 6 to 14 characters, and longer ones fail with a generic error.

Is PetKit free?

Yes. PetKit is free to use.

How do I add PetKit to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-petkit --env PETKIT_EMAIL='<PETKIT_EMAIL>' --env PETKIT_PASSWORD='<PETKIT_PASSWORD>' --env PETKIT_REGION='<PETKIT_REGION>' -- npx -y mcp-server-petkit

What are the best alternatives to PetKit?

The closest alternatives to PetKit are Home Automation Mcp, myIO, Gumball, Push Drop Stick: force-free dog training and Paws of London.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers