TeamSpeak MCP

A Model Context Protocol (MCP) server for controlling TeamSpeak from AI models like Claude.

Requirements

• Python 3.10-3.12
• Docker (optional, for containerized deployment)
• TeamSpeak 3 Server with ServerQuery enabled

Features

• 🎯 Connect to TeamSpeak servers
• 💬 Send messages to channels, private messages, and pokes (alert notifications)
• 📋 List connected users and detailed client information
• 🔧 Advanced channel management (create, delete, update properties, permissions)
• 🔇 AFK/Silent channel setup with talk power presets
• 🎵 Voice control (mute, unmute, kick, ban)
• 🛡️ Fine-grained permission management per channel
• 🖥️ Virtual server configuration (name, description, limits, welcome messages)
• 👥 User permission management (server groups, individual permissions)
• 📊 Comprehensive server and channel diagnostics
• 📝 Enhanced logging system with:
  • Automatic log configuration
  • Log diagnostics
  • Instance-level logs
  • Advanced filtering
  • Real-time notifications
• ⚙️ 39 powerful tools for complete TeamSpeak automation

🎯 Integration Methods Overview

TeamSpeak MCP offers multiple integration methods to fit your setup and preferences:

📦 Method 1: PyPI Package (Recommended for most users)

• ✅ Easiest setup - One command installation
• ✅ Automatic updates via standard package managers
• ✅ Standard MCP pattern - Compatible with Claude Desktop examples
• ✅ No Docker required - Pure Python implementation

# Installation
uvx install teamspeak-mcp

# Usage
uvx teamspeak-mcp --host your-server.com --user your-user --password your-password

# Claude Desktop config (CLI args)
{
  "mcpServers": {
    "teamspeak": {
      "command": "uvx",
      "args": ["teamspeak-mcp", "--host", "your-server.com", "--user", "your-user", "--password", "your-password"]
    }
  }
}