How to add Redis MCP Server to Cursor

Official Redis server: natural-language access to keys, search, and data structures in Redis. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Redis MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Redis MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Redis MCP Server config there under the "mcpServers" key and restart the client.

Is Redis MCP Server safe to use with Cursor?

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