Redis MCP
The official Redis MCP Server is a natural language interface designed for agentic applications to manage and search data in Redis efficiently
What is Redis MCP?
Redis MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to official redis mcp server is a natural language interface designed for agentic applications to manage and search data in redis efficiently
The official Redis MCP Server is a natural language interface designed for agentic applications to manage and search data in Redis efficiently
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- The official Redis MCP Server is a natural language interfac
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-redisConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Redis MCP
The official Redis MCP Server provides a natural language interface that lets AI agents and MCP clients manage and search data in Redis using conversational commands. It supports the full Redis data model including strings, hashes, lists, sets, sorted sets, pub/sub channels, streams, and JSON documents, as well as vector search and index management. Teams building agentic applications use it to give Claude and other LLMs direct, structured access to Redis for caching, session management, real-time messaging, and semantic vector search without writing any Redis commands directly.
Prerequisites
- Python 3.14 or later (the PyPI package requires Python 3.14+)
- uv package manager installed (recommended for running with uvx) — install via 'pip install uv' or from https://docs.astral.sh/uv/
- A running Redis instance (local via 'redis-server', Redis Cloud, or Azure Managed Redis)
- Redis Stack or Redis with the Search and JSON modules if you need vector search or JSON tools
- An MCP client such as Claude Desktop, Cursor, or VS Code with GitHub Copilot
Ensure Redis is running
Start a local Redis instance or use an existing Redis Cloud URL. For vector search and JSON support, use Redis Stack.
# Local Redis with Docker
docker run -d -p 6379:6379 redis/redis-stack:latest
# Or start a local redis-server if installed
redis-serverInstall the server via PyPI
Install redis-mcp-server from PyPI. The easiest way to run it is with uvx, which creates a temporary environment on the fly.
pip install redis-mcp-server
# or use uvx directly without installing:
# uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0Test the server from the command line
Verify the server starts correctly by running it with your Redis URL. It should print that it is listening for MCP connections.
uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0Add the server to your MCP client configuration
Add the Redis MCP server to your claude_desktop_config.json or equivalent MCP client config file. Replace the URL with your actual Redis connection string.
{
"mcpServers": {
"RedisMCPServer": {
"command": "uvx",
"args": [
"--from",
"redis-mcp-server@latest",
"redis-mcp-server",
"--url",
"redis://localhost:6379/0"
]
}
}
}For password-protected or SSL Redis, use the full URL format
Redis Cloud and enterprise instances require authentication and SSL. Use the rediss:// scheme and include credentials in the URL.
# SSL with credentials (Redis Cloud)
rediss://username:[email protected]:6380/0?ssl_cert_reqs=required&ssl_ca_certs=/path/to/ca.crt
# Or configure via individual environment variables instead of URL:
# REDIS_HOST, REDIS_PORT, REDIS_PWD, REDIS_SSLRedis MCP Examples
Client configuration
Full claude_desktop_config.json entry for the official Redis MCP server using uvx. Adjust the URL to match your Redis deployment.
{
"mcpServers": {
"RedisMCPServer": {
"command": "uvx",
"args": [
"--from",
"redis-mcp-server@latest",
"redis-mcp-server",
"--url",
"redis://localhost:6379/0"
],
"env": {
"REDIS_HOST": "localhost",
"REDIS_PORT": "6379",
"REDIS_PWD": "",
"REDIS_SSL": "false"
}
}
}
}Prompts to try
Ask Claude to interact with Redis using natural language. The server handles the translation to Redis commands automatically.
- "Store the current conversation summary in a Redis stream called 'chat-history'"
- "Cache this user session data with a 30-minute expiration"
- "Search for all hash keys matching the pattern 'user:*' and return their email fields"
- "Add this product to the leaderboard sorted set with a score based on sales volume"
- "Publish a notification to the 'order-updates' channel that order #1234 has shipped"Troubleshooting Redis MCP
Connection refused error when starting the server
Verify Redis is running and reachable: 'redis-cli -u redis://localhost:6379 ping' should return PONG. Check that the URL in your config matches the actual host, port, and authentication settings of your Redis instance.
Vector search or JSON tools are not available
These features require Redis Stack or the RedisSearch and RedisJSON modules. A plain Redis installation does not include them. Use 'docker run -d -p 6379:6379 redis/redis-stack:latest' to get all modules locally.
SSL certificate errors connecting to Redis Cloud
Download your Redis Cloud CA certificate from the database configuration page and pass its path in the URL: rediss://user:pass@host:port/0?ssl_cert_reqs=required&ssl_ca_certs=/path/to/ca.crt — or set ssl_cert_reqs=none to skip verification (not recommended for production).
Frequently Asked Questions about Redis MCP
What is Redis MCP?
Redis MCP is a Model Context Protocol (MCP) server that official redis mcp server is a natural language interface designed for agentic applications to manage and search data in redis efficiently It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Redis MCP?
Follow the installation instructions on the Redis MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Redis MCP?
Redis MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Redis MCP free to use?
Yes, Redis MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Redis MCP Alternatives — Similar Databases Servers
Looking for alternatives to Redis MCP? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Redis MCP 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 Redis MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.