Natural-language MCP server that lets agentic applications read/write/search data in Redis (strings, hashes, lists, sets, streams, vectors, JSON, etc.).
Setup guide, usage examples, and detailed information
Stop writing Redis commands. Start speaking to your database.
The Redis MCP Server transforms how AI agents interact with Redis, enabling natural language operations across all Redis data structures. Instead of translating business logic into Redis commands, your AI applications can simply say "cache this conversation" or "find similar vectors" and let the MCP server handle the complexity.
Building AI applications means bridging two worlds: the natural language capabilities of LLMs and the structured operations of databases. Traditional approaches force you to:
The Redis MCP Server eliminates this friction entirely.
Your AI agents interact with Redis using natural language. No more writing Redis clients, connection management, or command translation logic.
# Before: Complex Redis integration redis_client = redis.Redis(host='localhost', port=6379, decode_responses=True) conversation_key = f"session:{session_id}" redis_client.xadd(conversation_key, {"role": "user", "message": user_input}) redis_client.expire(conversation_key, 3600) # After: Natural language MCP "Store this conversation in a stream with 1-hour expiration"
One interface handles everything Redis offers:
Enterprise-grade features built-in:
Agent: "Store this support ticket in a hash with priority score and retrieve similar past issues"
Agent: "Index this user's behavior vector and find the top 10 similar users"
Agent: "Publish this event to the analytics channel and store in audit stream"
Agent: "Cache this expensive API response for 5 minutes with smart invalidation"
Claude Desktop: One-click installation via Smithery or manual configuration for immediate AI agent Redis access.
VS Code with GitHub Copilot: Native MCP integration in agent mode for Redis operations during development.
OpenAI Agents SDK: Direct integration for building production AI agents with Redis persistence.
Docker & Cloud: Deploy anywhere with official container images and comprehensive environment configuration.
The Redis MCP Server integrates into your existing workflow without requiring architectural changes. Whether you're prototyping with Claude Desktop or building production systems with the OpenAI SDK, the same natural language interface scales from development to deployment.
Configuration is environment-driven - no hardcoded connections or credentials. Transport options adapt to your deployment needs. Enterprise security features ensure production readiness without additional complexity.
Transform your AI applications from Redis command translators into intelligent data partners. The Redis MCP Server handles the complexity so your agents can focus on delivering value.
Ready to eliminate Redis integration friction? Install the Redis MCP Server and start building AI applications that speak fluent database.
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt # requirements.txt lives in the repo root
export REDIS_URL="redis://localhost:6379/0" # connection string
export OPENAI_API_KEY="sk-…" # if using OpenAI-backed tools
python -m mcp_redis.server
# or, if a CLI wrapper is provided:
mcp-redis serve --host 0.0.0.0 --port 8080
curl -X POST http://localhost:8080/mcp -d '{"query": "list keys"}'
docker build -t redis/mcp-redis .
docker run -e REDIS_URL=redis://host.docker.internal:6379/0 -p 8080:8080 redis/mcp-redis