Skip to content
MCP Shelf

Redis MCP Server

Redis's own server: keys, hashes, streams, JSON and vector search in plain English.

View on GitHub
  • Needs your setup first
  • ★ 641 GitHub stars
  • 11 downloads a week
  • Last commit 26 Oct 2026

What is Redis MCP Server?

Redis MCP Server is Redis's official server that lets an AI assistant read and write Redis data types, from strings and hashes to streams and JSON, and run vector search on Redis 8.

Tools
53
Runs on
Your computer
Licence
MIT
GitHub stars
641

Good for

  • Inspecting what is actually in a cache or session store while debugging
  • Prototyping agent memory with streams, hashes or JSON documents
  • Trying vector search on Redis 8 without writing the index commands yourself

You'll need

  • uv (for uvx)
  • A Redis server or Redis Cloud database you can reach, and its URL
Works withClaude CodeCursorClaude DesktopVS CodeCodexWindsurfEach has a ready-made config on the Install tab, built from the README.

Needs your setup firstIt needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 10 Nov 2026 we read its tools from the source code instead of running this config. The npm package "mcp-redis" in the shared database is not from Redis. Redis publishes this server on PyPI as redis-mcp-server, and its README starts it with uvx --from redis-mcp-server@latest, which is the config here.

Try asking Redis MCP Server

Once it is installed, ask your assistant things like:

  • Show me the keys that start with session: and when they expire.
  • Store this user profile as a hash under user:42.
  • Find the five documents most similar to this query in my vector index.

MCP Shelf take

Redis needs something our Linux test machine does not have (an account, an app or a service), so on 10 Nov 2026 we read its source and counted 53 tools. 27 of the 53 only read; the other 26 can change things. Other directories point at a package with the same name that belongs to someone else; the config on this page installs the real one. It sits 10th of 10 in its category on our shelf by GitHub stars (641, with 11 downloads a week).
MCP Shelf tests: numbers from our own runs, not the README · tested on 10 Nov 2026

What can Redis MCP Server read and change?

It can read

  • Any key and value the Redis user can read
  • Server statistics and the list of connected clients
  • The Redis documentation, through the docs search tool

It can change

  • Keys and values of every type, including deletes, renames and expiry times
  • Search indexes and stream consumer groups

Safer setup: The server has no read-only switch. Create a Redis ACL user with only read commands, for example ACL SETUSER readonlyuser on >password ~* +@read -@write, and connect as that user.

Redis MCP Server in more detail

Redis maintains this server, which gives an assistant around fifty tools covering the main Redis data types: strings with expiry, hashes, lists, sets, sorted sets, streams with consumer groups, JSON documents and pub/sub. It can also build a vector index on hashes and run a KNN or hybrid search, scan keys without blocking the server, and search the Redis documentation.

Most of its tools write, and the server has no read-only switch of its own. The README points to Redis ACLs instead: connect as a user that only has the @read commands and every write fails at the database, whatever the model tries.

Made by
Redis (redis/mcp-redis)
Latest version
0.5.1 (5 Aug 2026)
PyPI package
redis-mcp-server
Downloads
11 a week
Last commit
26 Oct 2026
Setup checked
10 Nov 2026
Page updated
10 Nov 2026

What's in the pod

What tools does Redis MCP Server have?

We found 53 tools in its source code on 10 Nov 2026. 27 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

How we tested it: Read from the source of redis-mcp-server 0.5.1 on PyPI. It needs a running Redis to start, which our test machine does not have.

Changes things26 tools · Can create, edit, send or delete.

ToolWhat it is for
create_vector_index_hashBuilds an HNSW vector index over hashes.
deleteDeletes a key.
expireSets a key to expire after a number of seconds.
hdelRemoves a field from a hash.
hsetSets one field in a hash, with an optional expiry on the key.
json_delDeletes the JSON at a path.
json_setWrites a JSON value at a path in a document.
lpopTakes the first value off a list.
lpushAdds a value to the start of a list.
lremRemoves matching values from a list.
publishSends a message to a pub/sub channel.
renameRenames a key.
rpopTakes the last value off a list.
rpushAdds a value to the end of a list.
saddAdds a member to a set.
setSets a string value, with an optional expiry.
set_vector_in_hashStores a list of numbers as a binary vector field in a hash.
sremRemoves a member from a set.
xackMarks entries as processed by a group.
xaddAppends an entry to a stream.
xdelDeletes an entry from a stream.
xgroup_createCreates a consumer group on a stream.
xgroup_destroyDeletes a consumer group.
xreadgroupReads new entries for a consumer in a group.
zaddAdds a member with a score to a sorted set.
zremRemoves a member from a sorted set.

Only reads27 tools · Looks things up and changes nothing.

ToolWhat it is for
client_listLists the clients connected to the server.
dbsizeCounts the keys in the database.
getReads a string value.
get_index_infoShows an index's schema and stats (FT.INFO).
get_indexed_keys_numberCounts the keys an index covers.
get_indexesLists the search indexes in the database.
get_vector_from_hashReads a vector field back from a hash as numbers.
hexistsChecks whether a hash has a field.
hgetReads one field from a hash.
hgetallReads every field and value in a hash.
hybrid_searchCombines a filter expression with a KNN vector search.
infoReturns server information and statistics, optionally one section.
json_getReads the JSON at a path.
llenCounts the items in a list.
lrangeReads a range of a list.
psubscribeSubscribes to every channel that matches a pattern.
read_messagesReads the messages waiting on a subscription handle.
scan_all_keysKeeps scanning until it has every matching key.
scan_keysLists keys matching a pattern a page at a time, without blocking the server.
search_redis_documentsSearches the Redis documentation and tutorials with a plain-English question.
smembersLists a set's members.
subscribeSubscribes to a channel and returns a handle for reading later.
typeSays what type of value a key holds.
unsubscribeCloses a subscription.
vector_search_hashFinds the nearest vectors to a query vector (KNN).
xrangeReads entries from a stream.
zrangeReads a range of a sorted set, optionally with scores.

Tool groups

Data types
Strings, hashes, lists, sets, sorted sets, streams with consumer groups, and JSON documents, each with read and write tools.
Pub/sub
Publish, subscribe by channel or pattern, read queued messages and unsubscribe.
Query engine
List and inspect indexes, build an HNSW vector index on hashes, and run KNN or hybrid vector search. Needs Redis 8 or Redis Stack.
Keys and server
Scan, type, expire, rename and delete keys; database size, INFO and the client list; and Redis docs search.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

How do I install Redis MCP Server?

Quick install

Pick your app and paste this in. It follows the README's own install steps below.

Where it goes: Your terminal, in the project folder

Claude Code
claude mcp add redis -- uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0
Codex, Windsurf, ChatGPT and more →

Install steps from the Redis MCP Server README

The project's own instructions, copied from its README on GitHub on 10 Nov 2026 under its MIT licence. They are the source of truth; the ready-made configs further down are built from them. The full README is on GitHub.

From PyPI (recommended)

Configuring the latest Redis MCP Server version from PyPI, as an example, can be done importing the following JSON configuration in the desired framework or tool. The uvx command will download the server on the fly (if not cached already), create a temporary environment, and then run it.

{
  "mcpServers": {
    "RedisMCPServer": {
      "command": "uvx",
      "args": [
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "\"redis://localhost:6379/0\""
      ]
    }
  }
}
URL specification

The format to specify the --url argument follows the redis and rediss schemes:

redis://user:secret@localhost:6379/0?foo=bar&qux=baz

As an example, you can easily connect to a localhost server with:

redis://localhost:6379/0

Where 0 is the logical database you'd like to connect to.

For an encrypted connection to the database (e.g., connecting to a Redis Cloud database), you'd use the rediss scheme.

rediss://user:secret@localhost:6379/0?foo=bar&qux=baz

To verify the server's identity, specify ssl_ca_certs.

rediss://user:secret@hostname:port?ssl_cert_reqs=required&ssl_ca_certs=path_to_the_certificate

For an unverified connection, set ssl_cert_reqs to none

rediss://user:secret@hostname:port?ssl_cert_reqs=none

Configure your connection using the available options in the section "Available CLI Options".

Claude Desktop

The simplest way to configure MCP clients is using uvx. Add the following JSON to your claude_desktop_config.json, remember to provide the full path to uvx.

Basic Redis connection:

{
  "mcpServers": {
    "redis-mcp-server": {
        "type": "stdio",
        "command": "/Users/mortensi/.local/bin/uvx",
        "args": [
            "--from", "redis-mcp-server@latest",
            "redis-mcp-server",
            "--url", "redis://localhost:6379/0"
        ]
    }
  }
}

Azure Managed Redis with EntraID authentication:

{
  "mcpServers": {
    "redis-mcp-server": {
        "type": "stdio",
        "command": "/Users/mortensi/.local/bin/uvx",
        "args": [
            "--from", "redis-mcp-server@latest",
            "redis-mcp-server",
            "--url", "redis://your-azure-redis.redis.cache.windows.net:6379"
        ],
        "env": {
            "REDIS_ENTRAID_AUTH_FLOW": "default_credential",
            "REDIS_ENTRAID_SCOPES": "https://redis.azure.com/.default"
        }
    }
  }
}
VS Code with GitHub Copilot

To use the Redis MCP Server with VS Code, you must nable the agent mode tools. Add the following to your settings.json:

{
  "chat.agent.enabled": true
}

You can start the GitHub desired version of the Redis MCP server using uvx by adding the following JSON to your mcp.json file:

"servers": {
  "redis": {
    "type": "stdio",
    "command": "uvx",
    "args": [
      "--from", "redis-mcp-server@latest",
      "redis-mcp-server",
      "--url", "redis://localhost:6379/0"
    ]
  },
}
Suppressing uvx Installation Messages

If you want to suppress uvx installation messages that may appear as warnings in MCP client logs, use the -qq flag:

"servers": {
  "redis": {
    "type": "stdio",
    "command": "uvx",
    "args": [
      "-qq",
      "--from", "redis-mcp-server@latest",
      "redis-mcp-server",
      "--url", "redis://localhost:6379/0"
    ]
  },
}

The -qq flag enables silent mode, which suppresses "Installed X packages" messages that uvx writes to stderr during package installation.

Alternatively, you can start the server using uv and configure your mcp.json. This is usually desired for development.

// mcp.json
{
  "servers": {
    "redis": {
      "type": "stdio",
      "command": "<full_path_uv_command>",
      "args": [
        "--directory",
        "<your_mcp_server_directory>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<your_redis_database_hostname>",
        "REDIS_PORT": "<your_redis_database_port>",
        "REDIS_USERNAME": "<your_redis_database_username>",
        "REDIS_PWD": "<your_redis_database_password>",
      }
    }
  }
}

For more information, see the VS Code documentation.

Tip: You can prompt Copilot chat to use the Redis MCP tools by including #redis in your message.

Note: Starting with VS Code v1.102, MCP servers are now stored in a dedicated mcp.json file instead of settings.json.

What you need first

  • uv (for uvx)
  • A Redis server or Redis Cloud database you can reach, and its URL

Add Redis MCP Server to your app

Pick your app for a ready-to-paste snippet and where it goes, built from the steps above.

Where it goes: Your terminal, in the project folder

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

Change the URL to your own database: rediss:// for TLS, with the user and password in it. For a safer start, create a read-only ACL user and connect as that.

Checked against the project's own install docs on 10 Nov 2026: redis/mcp-redis README, pypi.org/project/redis-mcp-server.

Did this work for you?

Projects change their install steps often. If Redis MCP Server did not install, or something here no longer matches the project, tell us and we will check it against the README and fix the page.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop, VS Code, Codex and ChatGPT. If it will not start, test it in MCP Inspector and look up the error in Fixing MCP server errors.

Redis MCP Server not working? Common fixes

Claude Desktop says it cannot find uvx
Give the full path to uvx in the command field, as the README's Claude Desktop example does (which uvx shows it).
Install messages from uvx show up as warnings in the client log
Add -qq as the first argument, before --from, to make uvx silent.
Connection refused
Check that Redis is running and reachable at the URL. For Redis Cloud or any TLS endpoint, use rediss:// rather than redis://.
Vector index or search commands fail
The query engine tools need the search module, which is built into Redis 8 and Redis Stack but not into older plain Redis.

How do I configure Redis MCP Server?

Names are exactly as the project spells them. Required ones are marked.

SettingWhat it does
--urlCommand line flagThe database to connect to, as a redis:// or rediss:// (TLS) URL with an optional user, password and database number.rediss://user:secret@redis.example.com:6379/0
--host, --port, --db, --username, --passwordCommand line flagThe same connection as separate flags. Defaults are 127.0.0.1, 6379 and database 0.
--ssl and --ssl-ca-certsCommand line flagTurn on TLS and name the CA bundle to check the server against. --ssl-cert-reqs none skips the check, which you should not do in production.
--cluster-modeCommand line flagConnect to a Redis Cluster rather than a single node.
REDIS_HOST, REDIS_PORT, REDIS_USERNAME, REDIS_PWDEnvironment variableThe connection through environment variables instead of flags. Flags win when both are set.
REDIS_ENTRAID_AUTH_FLOWEnvironment variableSigns in to Azure Managed Redis with Entra ID: service_principal, managed_identity or default_credential. Tokens renew on their own.default_credential
MCP_REDIS_LOG_LEVELEnvironment variableHow much the server logs to stderr. WARNING by default.INFO

Redis MCP Server FAQ

Is the Redis MCP Server official?

Yes. Redis maintains it in the redis organisation on GitHub and publishes it to PyPI as redis-mcp-server, under the MIT licence.

How do I install the Redis MCP Server?

With uv installed, add a server that runs uvx --from redis-mcp-server@latest redis-mcp-server --url followed by your database URL. uvx downloads and runs it on demand, so there is nothing else to install.

Can I make it read-only?

Not with a flag. Use Redis ACLs instead: create a user that only has the @read commands and connect as that user, and every write is refused by Redis itself.

Does it work with Redis Cloud and Azure Managed Redis?

Yes. Use a rediss:// URL with your Redis Cloud user and password. For Azure Managed Redis it can also sign in with Entra ID through a service principal, a managed identity or your Azure CLI login.

Can it do vector search?

Yes, on Redis 8 or Redis Stack. It can store embeddings in hashes, build an HNSW index over them and run nearest-neighbour or hybrid searches, which makes it handy for agent memory experiments.

Why not npx mcp-redis?

That npm name is not published by Redis. The official server is a Python package on PyPI, redis-mcp-server, and the README runs it with uvx.

Does it support remote or HTTP clients?

Not yet. It talks to clients over stdio, and the README says streamable HTTP will come later. The Redis database itself can be anywhere you can reach.

What does it cost?

The server is free and open source. You pay only for the Redis you run it against, and Redis Cloud has a free database to start with.

How do I add Redis MCP Server to Cursor?

In ~/.cursor/mcp.json, or .cursor/mcp.json for one project, add an entry named redis that runs uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0. Save, and the tools show up in Agent chat.

Can I use Redis MCP Server in VS Code?

Yes, through GitHub Copilot. In .vscode/mcp.json, add a server named redis with type stdio that runs uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0. Turn on agent mode (chat.agent.enabled), then mention #redis in a chat to point Copilot at these tools.

Does Redis MCP Server work with Codex?

Yes. Run codex mcp add redis -- uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0 in a terminal, or add an [mcp_servers.redis] table to ~/.codex/config.toml, which the Codex CLI and IDE extension share.

Two peas, one chat

Chat with AI about Redis

Opens a chat primed with Redis’s README and setup docs from this page, or add it in Cursor to use its tools.

The Cursor button opens Cursor and asks before it adds the server. Fill in any keys it needs in Cursor’s MCP settings.

Peas in a pod

What are the alternatives to Redis MCP Server?

How Redis MCP Server lines up against its neighbours on the shelf. See every databases and data server.

  • Redis MCP ServerThis pea

    Redis's own server: keys, hashes, streams, JSON and vector search in plain English.

    Tools
    53
    Runs on
    Your computer
    Licence
    MIT
    Stars
    641
  • Postgres MCP Pro

    SQL, query plans, health checks and index advice for Postgres.

    Tools
    9
    Runs on
    Your computer
    Licence
    MIT
    Stars
    3.4K
  • Supabase

    Manage Supabase projects, tables, migrations, logs and Edge Functions.

    Tools
    29
    Runs on
    Hosted
    Licence
    Apache-2.0
    Stars
    3K
  • MCP Toolbox for Databases

    Google's toolbox for Postgres, MySQL, BigQuery, Spanner and other databases.

    Tools
    29
    Runs on
    Your computer
    Licence
    Apache-2.0
    Stars
    16.7K
  • Qdrant

    Store notes and find them by meaning in a Qdrant vector collection.

    Tools
    2
    Runs on
    Your computer
    Licence
    Apache-2.0
    Stars
    1.6K
  • Excel MCP Server

    Create, edit, format and chart .xlsx files, no Excel needed.

    Tools
    46
    Runs on
    Your computer
    Licence
    MIT
    Stars
    4.3K
Full docs on GitHubredis/mcp-redis

Something wrong on this page? Tell us.

For bots & AI agents

Machine-readable versions of Redis MCP Server and MCP Shelf. Fetch these instead of parsing this page.

This listing (.md)llms.txtllms-full.txtai.txtFull catalog (.md)API specMCP serverMCP manifestDeveloper docs