Skip to main content

Kaomojis for Discord

Drop `/kaomoji` into any channel and pull 61,000+ Japanese kaomoji straight from kaomojis.jp — search, random, categories, all in embeds.

🤖 Add to Discord — coming soon 🧩 Self-host the bot →

Features

/kaomoji search

Type a keyword — love, cat, sparkle — and get 1–5 embedded matches.

/kaomoji random

Instant mood booster — 1–5 random faces, optionally from a category.

/kaomoji category

Browse #happy, #love, #cute, #sad and 20+ more categories.

12 languages

English, 日本語, 中文, Español, 한국어, हिन्दी, Português, Français, Русский, Deutsch, Bahasa Indonesia, 繁體中文.

Minimal permissions

Only View Channels + Send Messages + Use Slash Commands.

Open source

Full source at github.com/kaomojis — self-host on any Node.js 18+ box.

Slash commands

One top-level command, four sub-commands. Every reply is an embed with a “View on kaomojis.jp” button.

/kaomoji search <query> [limit] [locale]
Top results for a keyword (1–5).
/kaomoji random [count] [category] [locale]
Random handful, optionally from a category.
/kaomoji category <name> [limit] [locale]
Browse a single category, e.g. `happy`, `sleepy`, `blushing`.
/kaomoji categories [locale]
List every category with counts.

How to add it to your server

Public listings are still in review. When the bot is live on top.gg / discord.bots.gg / discordbotlist.com, the button above becomes an **Add to Discord** OAuth link. The flow will look like this:

  1. Click **Add to Discord** — a Discord OAuth window opens.
  2. Pick the server you want the bot in (you must have *Manage Server* there).
  3. Leave the suggested permissions checked (View Channels + Send Messages + Use Slash Commands).
  4. Confirm — the bot joins silently and `/kaomoji` is usable within seconds.
https://discord.com/oauth2/authorize?client_id={CLIENT_ID}&permissions=274877910016&scope=bot+applications.commands

Self-host (advanced)

Prefer running your own copy? The bot is a tiny Node.js process (discord.js + dotenv). Boot it in five steps:

  1. Create a Discord application at discord.com/developers/applications and copy the token.
  2. Clone the `discord-bot/` folder from the kaomojis.jp repository.
  3. `npm install` inside the folder (discord.js + dotenv).
  4. `cp .env.example .env` and paste your `DISCORD_TOKEN` / `DISCORD_APP_ID`.
  5. `npm run register` (once) then `npm start`. The bot is live.

Source: discord-bot/ · License: MIT

Powered by the Kaomojis Public API

The bot is a thin client on top of the free Kaomojis Public API (OpenAPI 3.0). You can build your own bot, website, or CLI against the same endpoints — see /developers.

→ /developers

FAQ

Is the bot free?

Yes. No subscription, no ads in replies, no premium tier. The Kaomojis Public API itself is also free.

What data does it collect?

None beyond what Discord shows the bot in each interaction (server ID, user that ran the command). We do not log queries or messages.

Which permissions does it request?

View Channels, Send Messages, Embed Links, Use External Emojis, and Use Slash Commands. That is the minimum to post a reply with a link button.

Is it on top.gg yet?

Listings at top.gg, discord.bots.gg and discordbotlist.com are in preparation. Once live, we will update this page with the bot profile links.

Can I contribute?

Yes — the code lives under `discord-bot/` in the kaomojis.jp repo. Pull requests and bug reports at [email protected] are welcome.

More tools from kaomojis.jp

The same catalogue powers our free Public API, Chrome extension, Pinterest pack and 120 category × 12 language landing pages.

Home Developers Chrome Extension Pinterest About [email protected]

Last updated: 2026-04-15