Which integrations are available for this server?

Enables AI assistants to interact with [Twitch](/mcp/servers/integrations/twitch) channels through chat messaging, stream management (title/category updates), moderation tools (timeouts/bans), content creation (clips), and viewer engagement features (polls/predictions)

The Twitch MCP Server provides AI-powered tools for Twitch streamers to manage their streams and engage with audiences:

• Chat Management: Send and read messages, retrieve recent chat logs (last 20 messages), and analyze chat for topics and activity • Moderation: Timeout or ban users by username or descriptor, with chat log review available when no specific username is provided • Stream Management: Update stream title and category, and create clips of the current stream • Audience Engagement: Create interactive polls and predictions with customizable titles, choices/outcomes, and durations • Integration: Works seamlessly with coding/chat assistants like Qwen Code, LM Studio, and Claude for enhanced functionality

Twitch MCP Server

AI-powered tools for Twitch streamers, exposed via the Model Context Protocol (MCP). Connect your coding/chat assistants (Gemini CLI, Qwen Coder, Claude Code, etc.) to your Twitch chat for moderation, stream management, and engagement.

Quick Start (No Cloning Required)

Prerequisites

Node.js 14+ and Java 11+ available on your system PATH
A Twitch account with appropriate API credentials

Setup Configuration

Create a config file with your Twitch credentials (use bare access token, no "oauth:" prefix):

Windows: C:/Users/<you>/AppData/Roaming/twitch-mcp/config.json
macOS: ~/Library/Application Support/twitch-mcp/config.json
Linux: ~/.config/twitch-mcp/config.json

Example config.json:

{ "channel": "YOUR_TWITCH_USERNAME", "auth": "YOUR_TWITCH_ACCESS_TOKEN", "clientId": "YOUR_TWITCH_CLIENT_ID", "broadcasterId": "YOUR_BROADCASTER_ID", "showConnectionMessage": true }

Recommended AI CLI Tools

🥇 Primary Recommendation: Gemini CLI

Excellent MCP support with reliable connections
Free tier with generous limits
Great for day-to-day Twitch moderation and chat management

🥈 Secondary Recommendation: Qwen Coder CLI

Strong coding-focused AI with good MCP integration
Particularly good for stream development and technical discussions
Free and open-source

⚡ For Power Users: Claude Code

Most advanced reasoning capabilities
Best for complex moderation decisions and nuanced chat analysis
Note: Limited credits - save for heavy lifting tasks

Configuration Examples

Gemini CLI Configuration

Add to your Gemini settings:

{ "mcpServers": { "twitch-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "twitch-mcp-server@latest", "--config", "C:/Users/<you>/AppData/Roaming/twitch-mcp/config.json" ] } } }

Qwen Coder Configuration

Add to your Qwen settings:

{ "mcpServers": { "twitch-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "twitch-mcp-server@latest", "--config", "C:/Users/<you>/AppData/Roaming/twitch-mcp/config.json" ] } } }

Related MCP server: Twitch MCP Server

Features

Chat Management: Send and read messages, recent chat log, chat analysis
Moderation: Timeout/ban users (by username or descriptor keywords)
Stream Management: Update title/category, create clips
Interactive Tools: Create polls and predictions for viewer engagement

Installation Options

Option 1: NPX (Recommended)

No installation required - your AI tool will automatically fetch the latest version:

npx twitch-mcp-server@latest --config /path/to/config.json

Option 2: Global Install

npm install -g twitch-mcp-server twitch-mcp-server --config /path/to/config.json

Option 3: Local Development

See README-developers.md for building from source.

Usage Notes

Use a bare access token in auth field (no oauth: prefix needed)
Only one AI client should connect at a time to avoid conflicts
Ensure Node.js and Java are installed on the same system as your AI CLI
The server will automatically handle IRC formatting and API authentication

Troubleshooting

Authentication Issues:

Confirm auth is a bare token (no oauth: prefix)
Verify clientId and scopes match your generated token
Ensure broadcasterId matches your channel ID

Connection Problems:

Check that both Node.js and Java are in your system PATH
Try running java -version and node -version to verify installation
For Windows users: Make sure you're not running from WSL if your AI CLI is on Windows

NPX Prompts in Headless Environments:

The configurations above use -y flag for non-interactive execution
If you encounter prompts, add --yes to the npx command

Support

For general usage questions, check the troubleshooting section above
For development and contributions, see README-developers.md
For Claude-specific integration help, see CLAUDE.md

twitch-mcp