MCPgee
MCPgee
MCPgeeMCPgee

OpenPets

v1.0.0•Developer Tools•stable

Desktop pets for AI coding agents. Install pets, connect Claude Code via MCP, and see live coding status on your desktop.

ai-agentsbunclaude-codecoding-agentsdesktop-pet
Share:
907
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is OpenPets?

OpenPets is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to desktop pets for ai coding agents. install pets, connect claude code via mcp, and see live coding status on your desktop.

Desktop pets for AI coding agents. Install pets, connect Claude Code via MCP, and see live coding status on your desktop.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Desktop pets for AI coding agents. Install pets, connect Cla

Use Cases

Install desktop pets that show live coding status from Claude Code. Connect AI coding agents to interactive desktop visualization. Monitor AI agent activity through fun, animated desktop companions.
alvinunreal

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx openpets

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenPets

OpenPets is a desktop application that displays animated pixel-art pet companions on your screen and connects to AI coding agents via MCP so the pets react in real time to what the AI is doing — thinking, editing files, running tests, or completing tasks. The MCP server exposes three tools (openpets_status, openpets_react, openpets_say) that let agents like Claude Code send animations and speech bubbles to the desktop pet. Developers use it as a fun, low-distraction way to monitor AI agent activity without staring at a terminal log.

Prerequisites

  • A desktop operating system: macOS (Apple Silicon or Intel), Windows, or Linux
  • Node.js and npm installed (for the MCP package @open-pets/mcp)
  • An MCP-compatible AI coding agent such as Claude Code, Cursor, or a similar tool
  • The OpenPets desktop application installed from the GitHub releases page
1

Download and install the OpenPets desktop app

Go to the OpenPets releases page and download the installer for your operating system (macOS Apple Silicon/Intel .dmg, Windows .exe, or Linux .AppImage). Run the installer and launch the app.

https://github.com/alvinunreal/openpets/releases/latest
2

Launch the desktop app and note your pet ID

Open the OpenPets application. The pet will appear on your desktop. Note the pet ID shown in the app — you may need it if you want to target a specific pet from your MCP config.

3

Configure your MCP client to connect to OpenPets

Add the @open-pets/mcp package as an MCP server in your AI agent's configuration. This runs the MCP bridge that relays tool calls from the agent to the desktop app.

{
  "mcpServers": {
    "openpets": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@open-pets/mcp@latest"]
    }
  }
}
4

(Optional) Target a specific pet by ID

If you have multiple pets running, pass the --pet flag with the pet ID to direct reactions to a specific pet.

{
  "mcpServers": {
    "openpets": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@open-pets/mcp@latest", "--pet", "<petId>"]
    }
  }
}
5

Ask your AI agent to interact with the pet

With the MCP server connected, your AI agent can now call openpets_react to trigger animations (thinking, editing, testing, success, error) and openpets_say to display speech bubbles on the desktop pet.

OpenPets Examples

Client configuration (Claude Code)

Add OpenPets to your Claude Code MCP configuration so it can send live status updates to your desktop pet:

{
  "mcpServers": {
    "openpets": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@open-pets/mcp@latest"]
    }
  }
}

Prompts to try

Ask Claude Code or your agent to interact with your desktop pet:

- "Check my pet's status and show me the pet ID"
- "Set the pet reaction to 'thinking' while you analyze the codebase"
- "Make the pet say 'All tests passed!' after running the test suite"
- "Trigger the 'error' animation on the pet if the build fails"
- "Show a 'success' reaction on the pet when you finish the task"

Troubleshooting OpenPets

openpets_react tool call returns an error saying the pet is not reachable

Ensure the OpenPets desktop application is running. The MCP server communicates with the desktop app via a local connection — the app must be open for tool calls to work.

npx -y @open-pets/mcp@latest fails to install

Ensure Node.js 18+ and a working npm registry connection. Try running npx -y @open-pets/mcp@latest manually in a terminal to see the full error message. If you are behind a corporate proxy, configure npm's proxy settings.

Speech bubbles via openpets_say are truncated or rejected

The server validates speech content locally to prevent exposure of sensitive data like file paths or code snippets. Keep speech bubble messages short and non-technical — they are meant for status messages, not code output.

Frequently Asked Questions about OpenPets

What is OpenPets?

OpenPets is a Model Context Protocol (MCP) server that desktop pets for ai coding agents. install pets, connect claude code via mcp, and see live coding status on your desktop. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenPets?

Follow the installation instructions on the OpenPets GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OpenPets?

OpenPets works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenPets free to use?

Yes, OpenPets is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

OpenPets Alternatives — Similar Developer Tools Servers

Looking for alternatives to OpenPets? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "openpets": { "command": "npx", "args": ["-y", "openpets"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenPets?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides