Redis MCP Server
Enables users to perform Redis database operations using the Model Context Protocol (MCP) tools, allowing for efficient data management through commands like setting, getting, and scanning hash fields.
What is Redis MCP Server?
Redis MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables users to perform redis database operations using the model context protocol (mcp) tools, allowing for efficient data management through commands like setting, getting, and scanning hash fields...
Enables users to perform Redis database operations using the Model Context Protocol (MCP) tools, allowing for efficient data management through commands like setting, getting, and scanning hash fields.
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables users to perform Redis database operations using the
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx redis-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Redis MCP Server
The Redis MCP Server (from the official redis/mcp-redis repository) enables AI agents and MCP clients to perform Redis database operations through natural language, supporting hashes, lists, sets, sorted sets, streams, pub/sub, JSON documents, and vector search. It is the official Redis-maintained MCP integration designed to give agentic workflows direct, structured access to Redis for tasks like session storage, caching, leaderboards, real-time messaging, and semantic search. Both Claude Desktop and GitHub Copilot in VS Code are supported as MCP clients.
Prerequisites
- Python 3.14 or later
- uv or pip for installing the redis-mcp-server PyPI package
- A running Redis instance — Redis Stack recommended for JSON and vector search capabilities
- Redis credentials (host, port, password) for your target database
- An MCP client such as Claude Desktop, VS Code with GitHub Copilot, or Augment
Start a Redis instance
Run Redis Stack locally with Docker to get full module support including JSON and vector search. Alternatively, connect to an existing Redis Cloud or on-premise instance.
docker run -d --name redis-stack -p 6379:6379 redis/redis-stack:latestInstall the server package
Install redis-mcp-server from PyPI using pip or use uvx to run it without a persistent install.
pip install redis-mcp-serverTest connectivity
Verify the server can reach your Redis instance before adding it to your MCP client.
redis-cli -u redis://localhost:6379 ping
# Should return: PONGAdd to Claude Desktop configuration
Edit your claude_desktop_config.json to add the Redis MCP server entry. Use the --url argument to specify your Redis connection string, or use individual REDIS_* environment variables.
{
"mcpServers": {
"RedisMCPServer": {
"command": "uvx",
"args": [
"--from",
"redis-mcp-server@latest",
"redis-mcp-server",
"--url",
"redis://localhost:6379/0"
]
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop to load the new MCP server. You should be able to ask Claude to store, retrieve, and search data in Redis immediately.
Redis MCP Server Examples
Client configuration
Configuration for connecting to a password-protected Redis instance using environment variables instead of a URL.
{
"mcpServers": {
"RedisMCPServer": {
"command": "uvx",
"args": [
"--from",
"redis-mcp-server@latest",
"redis-mcp-server"
],
"env": {
"REDIS_HOST": "your-redis-host",
"REDIS_PORT": "6379",
"REDIS_PWD": "your-redis-password",
"REDIS_SSL": "false",
"REDIS_CLUSTER_MODE": "false"
}
}
}
}Prompts to try
Natural language commands that Claude can translate into Redis operations via the MCP server.
- "Set a cache key 'product:123' with this JSON data and a 1-hour expiration"
- "Get all fields from the hash 'user:456' and show me the profile data"
- "Scan for all keys matching 'session:*' and count how many exist"
- "Add these 5 items to the sorted set 'leaderboard' with their scores"
- "Search the Redis documentation for how to use sorted sets for time-series data"Troubleshooting Redis MCP Server
Server fails to connect with 'Connection refused' on port 6379
Ensure Redis is running with 'redis-cli ping'. If using Docker, check the container is up with 'docker ps'. Verify the REDIS_HOST and REDIS_PORT in your config match the actual Redis endpoint.
MCP server log shows errors — how do I check what went wrong?
Tail the Claude Desktop MCP server log with: tail -f ~/Library/Logs/Claude/mcp-server-redis.log (macOS). This log captures connection errors, tool call failures, and Redis exceptions with full context.
Vector search or JSON operations return 'unknown command' errors
Plain Redis does not include the Search or JSON modules. Switch to Redis Stack: 'docker run -d -p 6379:6379 redis/redis-stack:latest'. Redis Cloud databases with Search enabled also work.
Frequently Asked Questions about Redis MCP Server
What is Redis MCP Server?
Redis MCP Server is a Model Context Protocol (MCP) server that enables users to perform redis database operations using the model context protocol (mcp) tools, allowing for efficient data management through commands like setting, getting, and scanning hash fields. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Redis MCP Server?
Follow the installation instructions on the Redis MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Redis MCP Server?
Redis MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Redis MCP Server free to use?
Yes, Redis MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Redis MCP Server Alternatives — Similar Databases Servers
Looking for alternatives to Redis MCP Server? 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 Server 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 Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.