What is Groq?
Groq is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to groq mcp server
Groq MCP server
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Groq MCP server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx groqConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Groq
The Groq MCP Server connects AI assistants like Claude to Groq's ultra-fast inference platform, exposing text-to-speech, speech-to-text, vision, chat, and batch processing as tools within any MCP-compatible client. It lets you generate audio, transcribe recordings, analyze images, and run LLM inference at Groq-native speeds — all through natural language. Teams use it to add multi-modal AI capabilities to workflows without writing custom API integration code.
Prerequisites
- A Groq API key — sign up at console.groq.com to obtain GROQ_API_KEY
- Python 3.10+ with uv installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
- An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
- Git installed to clone the repository from source
Obtain your Groq API key
Log in to console.groq.com, navigate to API Keys, and create a new key. Copy the key — you will need it as the GROQ_API_KEY environment variable.
Install the Groq MCP server
Install directly via pip or uvx, or clone the repository and run the setup script for the recommended source installation.
# Option 1 — pip
pip install groq-mcp
# Option 2 — uvx (no permanent install)
uvx groq-mcp
# Option 3 — from source (recommended)
git clone https://github.com/groq/groq-mcp-server
cd groq-mcp
./scripts/setup.sh
./scripts/install.shAdd the server to your MCP client configuration
Edit your Claude Desktop config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) to register the Groq MCP server with your API key.
{
"mcpServers": {
"groq": {
"command": "uvx",
"args": ["groq-mcp"],
"env": {
"GROQ_API_KEY": "your-groq-api-key"
}
}
}
}Optionally set a custom output path
By default, generated files (audio, images) are saved to ~/Desktop. Set BASE_OUTPUT_PATH in the env block if you want them saved elsewhere.
"env": {
"GROQ_API_KEY": "your-groq-api-key",
"BASE_OUTPUT_PATH": "/Users/you/groq-outputs"
}Restart your MCP client and verify the connection
Restart Claude Desktop (or your chosen client). The Groq tools should appear in the tool list. Try a simple chat request to confirm the server is reachable.
Groq Examples
Client configuration
Complete claude_desktop_config.json entry for the Groq MCP server using uvx.
{
"mcpServers": {
"groq": {
"command": "uvx",
"args": ["groq-mcp"],
"env": {
"GROQ_API_KEY": "gsk_xxxxxxxxxxxxxxxxxxxx",
"BASE_OUTPUT_PATH": "/Users/you/Desktop"
}
}
}
}Prompts to try
Example natural-language prompts that exercise the five main Groq MCP capability areas.
- "Convert this paragraph to speech using the Arista-PlayAI voice and save the file"
- "Transcribe the audio file at /Users/me/recording.mp3"
- "Analyze this image and describe what you see: https://example.com/photo.jpg"
- "Using Groq chat, draft a concise summary of the following text at the fastest available model"
- "Retrieve the current Bitcoin price from the CoinGecko API and format it in a table"Troubleshooting Groq
Server fails to start with 'GROQ_API_KEY not set' error
Make sure GROQ_API_KEY is present in the env block of your MCP config and that you restarted the client after editing the file.
uvx command not found after installation
Run 'curl -LsSf https://astral.sh/uv/install.sh | sh' and then restart your terminal. Confirm with 'which uvx' before retrying.
Generated audio or image files are not appearing
Check that BASE_OUTPUT_PATH points to an existing writable directory, or remove it to fall back to the default ~/Desktop location.
Frequently Asked Questions about Groq
What is Groq?
Groq is a Model Context Protocol (MCP) server that groq mcp server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Groq?
Follow the installation instructions on the Groq GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Groq?
Groq works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Groq free to use?
Yes, Groq is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Groq Alternatives — Similar Coding Agents Servers
Looking for alternatives to Groq? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Groq in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Groq?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.