Redis MCP server

Redis's official server for working with Redis data structures, JSON documents, streams, pub/sub and vector search in natural language. Runs locally through uvx against a Redis URL.

Local (stdio)Credential

Set up Redis

Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.

Claude Code

Run in your terminal.

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

Cursor

Merge into ~/.cursor/mcp.json

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

Codex

Run in your terminal.

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

Gemini CLI

Merge into ~/.gemini/settings.json

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

OpenCode

Merge into ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "redis": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "redis://localhost:6379/0"
      ],
      "enabled": true
    }
  }
}

VS Code

Merge into .vscode/mcp.json

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

Using more than one server?Add to a config with other servers

Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, the Cursor JSON goes in claude_desktop_config.json. This is a local server that runs on your machine; see remote vs local servers and authentication and security basics.

Overview

Redis maintains an official MCP server in redis/mcp-redis. The redis-mcp-server package was last released as version 0.5.1 on 5 August 2026, and the repository had commits on 9 October 2026. It gives an agent a natural-language interface to the data in a Redis database, which is useful for exploring a cache, checking keys or building quick agent memory.

It covers most Redis data types. get and set handle strings, hset and hgetall hashes, json_get and json_set JSON documents, and further tools manage lists, sets, sorted sets and streams. Pub/sub tools publish and subscribe to channels. scan_keys, type, expire and rename help with key management, and info and dbsize report server state. For search, it can create vector indexes and run vector_search_hash or a hybrid search.

The example runs uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0, so you need uv installed. Change the URL to your own database. Use rediss:// for TLS, and see the README for username, password and certificate options. The agent can delete keys and change data, so connect it to a development instance or a Redis user with restricted ACL permissions, not to a production cache that other services depend on.

Example tools

  • get
  • set
  • hgetall
  • scan_keys
  • json_get
  • vector_search_hash

Tool names are upstream examples. The server's live tool list can differ.

Browse Database servers

Sources

This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.