Kaomoji MCP Server

MCP Server that provides CLI-safe kaomoji for AI Agents at key interaction points

Local serverstdioTypeScript

What is the Kaomoji MCP server?

Connect Kaomoji to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP Server that provides CLI-safe kaomoji for AI Agents at key interaction points. The kaomoji mcp server is what makes that connection.

What the server does

A Model Context Protocol (MCP) server that gives AI agents expressive kaomoji (ASCII emoticons) at key moments — thinking, celebrating, and apologizing. All kaomoji are CLI-safe: no full-width characters, no decorative Unicode, no rendering surprises in any terminal.

  • Show a thinking kaomoji before each sub-task so the user can follow progress in real time
  • Show a celebration kaomoji when a task completes successfully
  • Show an apology kaomoji when results are not found or an error occurs

Installation

kaomoji-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • subtle — gentle fix, formal context → (^-^)
  • moderate — regular task done → (^o^)/
  • intense — major breakthrough → (^∀^)/
  • not_found — search returned no results
  • error — unexpected error occurred
  • dissatisfied — user expressed unhappiness
  • thinking_kaomojiBefore each sub-task or reasoning phase
  • celebrate_kaomojiAfter a task completes successfully
  • apologize_kaomoji — On no-results, error, or user dissatisfaction
  • Tools — The Tools tool exposed by this server
  • Prompt — The Prompt tool exposed by this server
  • Resource — The Resource tool exposed by this server

Credentials and setup notes

  • Node.js ≥ 20

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Kaomoji.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Kaomoji's toolset — subtle, moderate, intense and 11 more — is a fair guide to whether it matches your workflow. It is maintained by frankunderwood-w; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
subtlegentle fix, formal context → (^-^)
moderateregular task done → (^o^)/
intensemajor breakthrough → \(^∀^)/
not_foundsearch returned no results
errorunexpected error occurred
dissatisfieduser expressed unhappiness
thinking_kaomoji**Before** each sub-task or reasoning phase
celebrate_kaomoji**After** a task completes successfully
apologize_kaomojiOn no-results, error, or user dissatisfaction
ToolsThe Tools tool exposed by this server.
PromptThe Prompt tool exposed by this server.
ResourceThe Resource tool exposed by this server.
RequirementsThe Requirements tool exposed by this server.
CursorOr via the Cursor UI: **Settings → Cursor Settings → MCP** → click **+ Add new MCP server** and enter the command above.

How to install the Kaomoji MCP server

Or, if you cloned the repo locally:

```json
{
  "mcpServers": {
    "kaomoji": {
      "command": "node",
      "args": ["/absolute/path/to/kaomoji-mcp/build/index.js"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js ≥ 20

Example prompts to try

  • Use Kaomoji to subtle.
  • Use Kaomoji to moderate.
  • Use Kaomoji to intense.

Frequently asked questions

It connects Kaomoji to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (subtle, moderate, intense, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Kaomoji directly.