tawk

tawk — a Claude Code plugin for tawk.to

Manage tawk.to live chat from Claude Code. Ask Claude things like "summarize last week's support chats" or "add the tawk widget to my site" — this plugin gives it the tools to do that.

What it does

• Read your chat history — list and summarize completed chats by date range
• List support tickets — filter by status and date
• Set up the chat widget — generates the embed code and Tawk_API customization for plain HTML, React, or Next.js, including secure mode
• Scaffold webhook receivers — ready-to-use endpoints (Express, Next.js, Cloudflare Workers) with signature verification built in
• Draft knowledge base content — turns recurring questions from your real chats into paste-ready KB articles

Quick start

1. Get API access (one-time): tawk.to requires approval for REST API access — request it via the REST API article (usually 24–48h). Then create a key: dashboard → Profile → Edit Profile → REST API Keys → Create Key.

2. Install the plugin (in Claude Code):

/plugin marketplace add beyrakIn/tawk-plugin
/plugin install tawk@tawk-marketplace

3. Set your API key (in your terminal, never in a file):

# Windows (PowerShell)
setx TAWK_API_KEY "your-key"

# macOS/Linux — add to your shell profile
export TAWK_API_KEY="your-key"

4. Restart Claude Code and run /tawk:setup — it verifies the connection and helps you set a default property.

Requires Node.js ≥ 18. No build step — the plugin ships compiled.

Tools and commands

MCP tool	Does
tawk_me	Verify auth; show the authenticated agent
tawk_list_properties	List your sites/properties
tawk_list_chats	Chat history by property and date range
tawk_list_tickets	Tickets filtered by status/date

Command	Does
/tawk:setup	Configure and verify API access
/tawk:chats [period]	Summarize recent chats
/tawk:tickets [status]	List and filter tickets

The widget, webhook, and knowledge-base skills activate automatically when you ask Claude about those topics — no commands needed.

Good to know

• tawk.to's API returns completed chats only — no live/incoming chats.
• Full chat transcripts aren't available yet — tawk.to's transcript endpoint could not be verified against the live API (see docs/api-notes.md); it will be added once confirmed.
• Knowledge base, widget settings, triggers, and webhook registration are dashboard-only in tawk.to. The plugin guides you through them and drafts the content instead of pretending an API exists.
• Rate limits are undocumented by tawk.to; the client retries 429s with backoff.

Security

• Your API key is read from the TAWK_API_KEY environment variable at startup and is never written to disk.
• Webhook scaffolds always verify the X-Tawk-Signature HMAC — keep it that way.

License

MIT