Petsonality — Claude Code MCP server: what it does, install
Petsonality puts an MBTI-based ASCII pet in the terminal. It reacts to coding events and gives you /pet commands for interaction.
claude mcp add petsonality -- npx -y petsonalityWhat Petsonality does
Petsonality runs a small ASCII companion in the terminal and gives it a personality based on MBTI. It reacts when code fails, may celebrate passing tests or successful commits, and speaks up after a quiet stretch. The /pet commands let you view the pet, browse the animals, rename it, or mute its reactions.
The MCP server is launched through npx and can be connected to Claude Code, Codex, Cursor, GitHub Copilot, and the other listed clients. Its installer includes the /pet skill, hooks, and status-line assets. It also updates ~/.claude.json and ~/.claude/settings.json; a source install requires Bun.
The animated pet needs a terminal status line. It will not render in the Claude Code desktop app or web client, although MCP output such as /pet show still works from any client.
What it helps with
- show a pet in the terminal status line
- react to coding errors during agent work
- acknowledge passing tests and successful commits
- browse and rename the selected animal
- mute or restore pet reactions
Example prompts for the agent
- Show my pet with
/pet. - List all available animals using
/pet browse. - Mute the pet with
/pet off.
How to install Petsonality
Platform CLI
claude mcp add petsonality -- npx -y petsonalityPlatform CLI
codex mcp add petsonality -- npx -y petsonalityConfig file
{
"mcpServers": {
"petsonality": {
"command": "npx",
"args": [
"-y",
"petsonality"
]
}
}
}Config file
{
"servers": {
"petsonality": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"petsonality"
]
}
}
}Platform CLI
gemini mcp add petsonality npx -y petsonalityStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Petsonality
How do I install Petsonality in Claude Code?
Run claude mcp add petsonality -- npx -y petsonality, restart the assistant, then enter /pet.
What does Petsonality do?
It is an MCP server that adds an ASCII terminal pet with an MBTI-based personality. The pet reacts to errors and selected development events.
Does the animated pet work in the Claude Code desktop app?
No. The animation uses a terminal status line, which the desktop app and web client do not expose. MCP output such as /pet show still works in any client.
