PetKit
Unofficial server to check and control PetKit Fresh Element Solo feeders
- 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-petkitAdd 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 accountRequiredPETKIT_PASSWORDPassword of your PetKit accountRequiredPETKIT_REGIONRegion name exactly as shown in the PetKit app (e.g. "Netherlands", "United States")RequiredPETKIT_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.