← Back to directory
M

MCP redis

Official
Natural language interface for managing and searching data in Redis for agentic applications.
Category
Database #17 of 58
Stars
★ 634 Very popular
Transport
stdio (local process)
Runtime
Python 3.14+ · Docker
Credentials
No credential needed
License
MIT
Last commit
Tools
11
60FMRS · C

This is the official Redis MCP server, feature-rich, supports multiple data structures and vector search, easy integration, but there are risks of data mishandling and credential leakage.

Strongest · Documentation 17/20 Weakest · Reliability 6/20

Reliability
6/20
Security and permissions
9/20
Maintenance
14/20
Documentation
17/20
Setup experience
14/20
Why each score
Reliability 6/20
Only the README and server manifest were supplied; no source code, CI workflows, or committed tests are available for review. The claimed stdio transport and broad tool set are plausible, but startup behavior, the MCP handshake, and actual tool behavior cannot be verified from static files. Score is lowered for lack of executable evidence and thin error-handling detail.
Security and permissions 9/20
No red-line issues were found: examples use placeholders, and there is no evidence of malware or covert exfiltration. However, the docs show credentials can be passed on the command line, where they may be visible in process listings. The default server appears to grant broad read/write/delete access; ACL least-privilege guidance exists, but there is no evidence of built-in confirmation for destructive operations or complete data-flow disclosure.
Maintenance 14/20
The repository is under the official Redis namespace, has an MIT license, is not archived, and references PyPI and Docker release paths plus tagged releases. This indicates an active project, but commit history, issue-response behavior, dependency-update logs, and a security-response channel were not provided, preventing a top score.
Documentation 17/20
The README is well-structured and covers installation, CLI options, environment variables, EntraID authentication, logging, and multiple client integrations with copy-paste JSON examples. Deductions apply because detailed tool parameter schemas are absent, cost or rate-limit information is not disclosed, and troubleshooting guidance is limited.
Setup experience 14/20
Setup is clearly documented for uvx/PyPI, GitHub, Docker, and development mode, with ready-to-use configuration examples for Claude Desktop and VS Code. Under the static calibration rule, setup cannot exceed 15 without real CI and test files in the supplied material. A small deduction is also made because the user must provide a running Redis instance and manually configure environment variables.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkConnects to a database

Best for

  • AI agents that need to interact with Redis
  • Applications that need natural language management of Redis data
  • Development workflows using MCP clients like Claude Desktop

Not for

  • Pure data pipelines without a natural language layer
  • Simple KV scenarios without MCP needs
  • Production systems requiring direct Redis for highest performance

Required permissions

  • Requires Redis connection credentials (URL, username, password)
  • Can read, write, and delete data in Redis
  • Can create indexes and perform searches

Risks and side effects

  • Data operation errors: AI may accidentally delete or overwrite data
  • Credential exposure: Redis credentials could be exposed if misconfigured
  • Resource consumption: Large vector indexes may consume memory

Setup

Before you start

Runtime:Python 3.14+ · Docker

REDIS_PWD optionalsecret Redis password, from your Redis instance ACL configuration.
REDIS_ENTRAID_CLIENT_SECRET optionalsecret Azure service principal client secret from the Azure portal.
Other optional settings (21)
REDIS_HOST optional Redis hostname, defaults to 127.0.0.1; use your Redis instance's address.
REDIS_PORT optional Redis port, defaults to 6379.
REDIS_DB optional Logical database number, defaults to 0.
REDIS_USERNAME optional Redis username, defaults to default.
REDIS_SSL optional Boolean enabling or disabling SSL/TLS.
REDIS_SSL_CA_PATH optional CA certificate path for verifying the server.
REDIS_SSL_KEYFILE optional Client private key path for mutual TLS.
REDIS_SSL_CERTFILE optional Client certificate path for mutual TLS.
REDIS_SSL_CERT_REQS optional Whether to verify the server certificate, default required.
REDIS_SSL_CA_CERTS optional Path to trusted CA certificates file.
REDIS_CLUSTER_MODE optional Boolean enabling Redis Cluster mode.
REDIS_ENTRAID_AUTH_FLOW optional EntraID flow: service_principal, managed_identity, or default_credential.
REDIS_ENTRAID_CLIENT_ID optional Azure service principal app (client) ID from the Azure portal.
REDIS_ENTRAID_TENANT_ID optional Azure tenant ID from the Azure portal.
REDIS_ENTRAID_IDENTITY_TYPE optional Managed identity type: system_assigned or user_assigned.
REDIS_ENTRAID_USER_ASSIGNED_CLIENT_ID optional Client ID of the user-assigned managed identity from the Azure portal.
REDIS_ENTRAID_SCOPES optional OAuth scope for Default Azure Credential, default https://redis.azure.com/.default.
REDIS_ENTRAID_RESOURCE optional Azure Redis resource identifier, default https://redis.azure.com/.
REDIS_URL optional Redis connection URI such as redis://user:pass@host:6379/0.
MCP_REDIS_LOG_LEVEL optional Log level such as DEBUG, INFO, WARNING; defaults to WARNING.
MCP_DOCS_SEARCH_URL optional HTTP API URL backing the docs tool's documentation search.
  1. Install via PyPI: pip install redis-mcp-server.
  2. Run with uvx: uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0.
  3. Or import the JSON config above into your MCP client.
claude_desktop_config.json
{
  "mcpServers": {
    "RedisMCPServer": {
      "command": "uvx",
      "args": [
        "--from", "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url", "redis://localhost:6379/0"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "RedisMCPServer": {
      "command": "uvx",
      "args": [
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "redis://localhost:6379/0"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add RedisMCPServer -- uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

The client's tool list should show tools from RedisMCPServer such as string, hash, streams, and query engine; alternatively, ask "how many keys are in the Redis database" to confirm the connection works.

Troubleshooting

  1. Check Redis connection accessibility (default localhost:6379)
  2. Ensure credentials are correct, especially password and ACL permissions
  3. Check logs: set `MCP_REDIS_LOG_LEVEL=DEBUG` environment variable to increase verbosity
  4. Confirm the `redis-server` service is running

Things to try

Once connected, you can ask your AI assistant things like:

  • Store this entire conversation in a Redis stream
  • Cache this item with a 60 second expiration
  • Index these vectors and search for the nearest matches
  • Show me memory usage information for the Redis database

Tools 11

string writes
Set and get string values with expiration.
hash writes
Store and manipulate hash fields, can store vector embeddings.
list writes
Append and pop list elements, suitable for queues or message brokers.
set writes
Add, remove, and list set members, support set operations.
sorted set writes
Manage sorted sets, useful for leaderboards, priority queues, etc.
pub/sub writes
Publish messages, create subscriptions, and read messages.
streams writes
Add, read, delete stream data, manage consumer groups.
JSON writes
Store, retrieve, and manipulate JSON documents.
Show 3 more tools
docs read-only
Search Redis documentation and best practices.
query engine writes
Manage vector indexes and perform vector search.
server management read-only
Retrieve database information.

Use cases

AI assistants accessing Redis data
Chatbots managing session data
Real-time data search and analytics
Event stream processing

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

The Redis MCP Server is the official MCP server from Redis, providing a natural language interface for agentic applications to manage and search data in Redis efficiently. It supports various Redis data structures (strings, hashes, lists, sets, sorted sets, streams, JSON), and offers documentation search and vector search tools. It can be installed via PyPI or Docker, configured via command-line arguments or environment variables, and supports EntraID authentication.

Similar servers

Source revision 712749ddc674 Data synced 2026-10-12 Read the FMRS scoring method