MCP Redis logo

MCP Redis

by redis

Connects MCP clients to Redis for natural-language data management, search, JSON, streams, pub/sub, and vector queries.

Install MCP Redis

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "redis-mcp-redis": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/redis/mcp-redis.git@0.2.0",
        "redis-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

uvx --from git+https://github.com/redis/mcp-redis.git@0.2.0 redis-mcp-server

Building redis-mcp-server @ git+https://github.com/redis/mcp-redis.git@dc54488ca41d595ca09e5a56f071a8fb31fa01d8 Downloading cryptography (4.5MiB) Downloading numpy (16.1MiB) Downloading pygments (1.2MiB) Downloading pydantic-core (2.0MiB) Downloaded pygments Downloaded pydantic-core Downloaded cryptography Downloaded numpy Built redis-mcp-server @ git+https://github.com/redis/mcp-redis.git@dc54488ca41d595ca09e5a56f071a8fb31fa01d8 Installed 40 packages in 29ms Traceback (most recent

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

redis/mcp-redis MCP server gives MCP clients a natural-language interface for managing and searching Redis data. It connects to a Redis instance through a Redis or rediss URI and communicates over stdio. Available operations cover common Redis data types, JSON documents, streams, pub/sub, vector indexes, and database information. Reach for it when an agent needs to read, write, search, or organize application data in Redis.

Use cases

  • Cache responses and configuration values in Redis
  • Store agent sessions with expiration times
  • Process event streams with consumer groups
  • Search Redis vector indexes
  • Publish updates through Redis pub/sub

Key features

  • Manage strings, hashes, lists, sets, and sorted sets
  • Read and process Redis Streams
  • Store and manipulate JSON documents
  • Publish messages and manage subscriptions
  • Create vector indexes and run vector searches
  • Search Redis documentation through an HTTP API

Tools8

What MCP Redis lets your agent do. Expand a tool for its parameters.

Self-reported~13 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/20 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · redis-mcp-server (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars641Stargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Tools exposed8Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Redis works

What redis/mcp-redis MCP server does

The redis/mcp-redis MCP server lets an MCP client interact with Redis through agent-facing tools. It supports common Redis structures and operations rather than limiting access to a single data model. Agents can work with strings, hashes, lists, sets, sorted sets, streams, and JSON documents. Hashes can also hold vector embeddings.

The server supports use cases such as caching values, storing session data with expiration, representing objects with field-value pairs, maintaining queues, tracking unique members, and building score-ordered collections. Stream tools cover adding and reading entries, managing consumer groups, deleting entries, and acknowledging processed messages. Pub/sub tools support publishing, stateful channel or pattern subscriptions, and reading queued messages through subscription handles.

Additional capabilities include tools for managing vector indexes and running vector searches, a server-management tool that returns database information, and a documentation search tool. The documentation search uses the MCP_DOCS_SEARCH_URL HTTP API and can retrieve Redis documentation, tutorials, and best practices.

How it works

The redis/mcp-redis MCP server uses the stdio transport. An MCP-compatible client starts the process and sends tool requests over standard input and output. The process connects to the target Redis database using a connection URI. The URI identifies the Redis host and port and can include a username, password, logical database number, and connection options.

Use redis:// for a standard connection or rediss:// for an encrypted connection. TLS settings can be supplied as URI options, including certificate verification behavior and a CA certificate path. The logical database is expressed in the URI path, such as /0.

Setup and configuration

The redis/mcp-redis MCP server is distributed as the redis-mcp-server PyPI package and can be run with uvx. A local Redis configuration uses:

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

The package can also be installed with pip, then started with the redis-mcp-server command and a --url argument. GitHub-based execution is supported with uvx; tagged releases are recommended because the main branch is under active development and may include breaking changes.

Redis credentials can be included in the URI, for example through the user:secret@host portion. Azure Managed Redis can use EntraID authentication. The documented runtime requires Python 3.14 or newer.

Limitations and notes

Streamable HTTP support is described as planned for the future. A reachable Redis deployment is required for data operations, and encrypted connections may require appropriate certificate settings. The documentation-search feature depends on the MCP_DOCS_SEARCH_URL HTTP API.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Redis

Run it from PyPI with uvx using the redis-mcp-server package, the redis-mcp-server entry point, and a Redis --url such as redis://localhost:6379/0.

Yes. The README includes Claude Desktop among its documented integrations and shows configuration through an MCP client.

It supports strings, hashes, lists, sets, sorted sets, streams, and JSON documents. It also provides pub/sub, vector query, server-management, and documentation-search tools.

Streamable HTTP support is planned for the future.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Redis AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/redis-mcp-redis?style=directory)](https://allmcps.com/mcp/redis-mcp-redis)
HTML Embed
<a href="https://allmcps.com/mcp/redis-mcp-redis"><img src="https://allmcps.com/api/badge/redis-mcp-redis?style=directory" alt="MCP Redis on AllMCPs" /></a>