How to add Redis MCP Server to Claude Desktop

Official Redis server: natural-language access to keys, search, and data structures in Redis. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 700★ · stdio · apikey · official

Claude Desktop config for Redis MCP Server

uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0

{
  "mcpServers": {
    "redis-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "redis://<user>:<password>@<host>:6379/0"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Redis MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Redis MCP Server's tools appear under the 🔌 tools menu.

Before you start

Python 3.14+ and the uv package manager (uvx is used to run the published package)
A reachable Redis instance (local, Redis Cloud, or Azure Managed Redis) and its connection URL or host/port
Redis credentials if your instance requires auth — a password and/or ACL username; for Azure Managed Redis you can use EntraID/Managed Identity instead
For vector search / JSON tools, a Redis with the Query Engine and JSON modules (e.g. Redis Stack or Redis 8+)

What Redis MCP Server can do in Claude Desktop

string

Set/get string values with optional expiration

hash

Manage hash field-value pairs, including storing vector embeddings

list

Append to and pop from Redis lists

set

Add, remove, and list set members

sorted set

Score-based add/range operations for leaderboards and priority queues

streams

Add, read, and delete stream entries and manage consumer groups

JSON

Store, retrieve, and manipulate JSON documents (RedisJSON)

pub/sub

Publish messages and manage subscriptions, including pattern matching

Security

The Redis connection URL can include the password, so avoid embedding production credentials in plaintext config and prefer a dedicated ACL user. An agent with write access can flush or overwrite keys, so scope permissions carefully.

Redis MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Redis MCP Server config there under the "mcpServers" key and restart the client.

Is Redis MCP Server safe to use with Claude Desktop?

How does it authenticate to Redis?

Pass a redis:// or rediss:// URL with embedded credentials, or set REDIS_USERNAME/REDIS_PWD. It supports Redis ACL users, TLS with certificate verification, and EntraID/Azure AD (Service Principal, Managed Identity, or Default Azure Credential) for Azure Managed Redis.

Do I need Redis Stack for vector search and JSON?

Yes for those features. The JSON and query-engine (vector index/search) tools require the RedisJSON and Query Engine modules, available in Redis Stack or Redis 8+. Core data-type tools work on any standard Redis.

What transport does it use?

stdio. The server runs over standard input/output for local MCP clients; HTTP streaming transport is noted as planned for the future.

View repo Full Redis MCP Server page