# PetKit

> PetKit is a free MCP server for pets. Unofficial server to check and control PetKit Fresh Element Solo feeders. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/dirkjanfaber/mcp-server-petkit
- **MCP Registry name:** io.github.dirkjanfaber/mcp-server-petkit
- **Categories:** [pets](https://ai-powered.com/categories/pets), [smart home](https://ai-powered.com/categories/smart-home)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Home Automation Mcp](https://ai-powered.com/mcp/home-automation-mcp): Home Automation Mcp is a freemium MCP server for smart home.
- [myIO](https://ai-powered.com/mcp/myio): myIO is an open-source MCP server for smart home.
- [Gumball](https://ai-powered.com/mcp/gumball): Gumball is an open-source MCP server for smart home.
- [Push Drop Stick: force-free dog training](https://ai-powered.com/mcp/push-drop-stick-force-free-dog-training): Push Drop Stick: force-free dog training is a freemium MCP server for pets.
- [Paws of London](https://ai-powered.com/mcp/paws-of-london): Paws of London is a free MCP server for pets.
- [Paw Multiverse animal poison services](https://ai-powered.com/mcp/paw-multiverse-animal-poison-services): Paw Multiverse animal poison services is a free MCP server for pets.
- [Paw Multiverse pet food recalls](https://ai-powered.com/mcp/paw-multiverse-pet-food-recalls): Paw Multiverse pet food recalls is a free MCP server for pets.
- [StationSignals](https://ai-powered.com/mcp/stationsignals): StationSignals is a freemium MCP server for smart home.

---
Source: https://ai-powered.com/mcp/petkit
