@dennisk2025/emoji-replacer

emoji-replacer-mcp

Replaces specific words in a text with corresponding emojis, making your text more expressive and fun!

Features

• Replace keywords like "happy", "cat", "coffee", etc. with their emoji equivalents in your text.
• Supports custom word-to-emoji mapping per request.

Installation

You can run via npx (recommended):

npx @dennisk2025/emoji-replacer-mcp

Or install globally:

npm install -g @dennisk2025/emoji-replacer-mcp

Or as a local dependency:

npm install @dennisk2025/emoji-replacer-mcp

Adding to Claude Desktop

Add the following to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "emoji-replacer": {
      "command": "npx",
      "args": ["@dennisk2025/emoji-replacer-mcp"]
    }
  }
}

Usage Examples

Available tool:

replace_words_with_emojis

Replaces predefined words in a text with their emoji equivalents. You can also supply additional or override mappings.

Parameters

• text (string, required): Input text where keywords will be replaced by emojis.
• emojis (object, optional): Optional custom mapping for word-to-emoji replacements.

Example Calls

1. Basic replacement:

Input:

{
  "name": "replace_words_with_emojis",
  "arguments": {
    "text": "I am happy to see my cat drink coffee."
  }
}

Output:

{
  "result": "I am 😊 to see my 🐱 drink ☕️."
}

2. Custom mapping:

Input:

{
  "name": "replace_words_with_emojis",
  "arguments": {
    "text": "Let's eat cake and play music under the sun!",
    "emojis": { "cake": "🎂", "sun": "🌞" }
  }
}

Output:

{
  "result": "Let\u0027s eat 🎂 and play 🎵 under the 🌞!"
}

Tool Reference

replace_words_with_emojis

• Description: Takes a string of text and replaces predefined keywords (like 'happy', 'cat', 'coffee') with their respective emojis. The mapping can be expanded and customized.
• Parameters:
  • text (string, required): Input text where keywords will be replaced by emojis.
  • emojis (object, optional): Mapping for custom replacements. Example: { "apple": "🍎" }
• Default mappings: happy, cat, dog, coffee, love, smile, sun, star, music, cake

Enjoy expressive text in Claude with emoji-replacer-mcp!