# Redis MCP Server (local)

> Lets your agent store, search and manage the data in your Redis database in plain words: caches, sessions, streams, JSON and vectors.

Redis's own MCP server, run on your machine as a local MCP server. It gives your agent a natural-language interface to a Redis database, so it can store and read data, work with Redis data structures and run vector search without you writing the commands. It's the same server Redis also ships as a Gemini CLI extension.

What you can do with it
- Set and get strings with an expiry, for caching and session data
- Work with hashes, lists, sets, sorted sets and streams, including stream consumer groups
- Store, read, update and delete JSON documents by path
- Create vector indexes and run vector and hybrid searches
- Publish messages to channels, subscribe to channels or patterns and read what's queued
- Scan, rename and delete keys, set expiries, and read server info, key counts and connected clients
- Search the Redis documentation for answers

How it connects
It runs locally with uvx from the redis-mcp-server package on PyPI, for example uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0, or with the official mcp/redis Docker image. Point it at your database with --url (redis://, or rediss:// for TLS connections such as Redis Cloud) or with the REDIS_HOST, REDIS_PORT, REDIS_USERNAME and REDIS_PWD environment variables. With nothing set, it connects to a local Redis at 127.0.0.1:6379.

Good to know
- uvx needs uv installed; the Docker image needs Docker.
- For read-only access, connect as a Redis ACL user without write permissions; Redis's README shows how to create one.
- It supports Redis Cluster mode and Microsoft Entra ID sign-in for Azure Managed Redis.
- Redis's README shows setups for Claude Desktop and VS Code with GitHub Copilot.

- Type: Plugin
- Made by: redis
- Category: Databases
- Formats: Local MCP
- Version: 0.5.1
- Source: https://github.com/redis/mcp-redis
- Page: https://pluginboard.ai/plugins/redis-mcp-server

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "redis-mcp-server-local": {
      "command": "uvx",
      "args": [
        "redis-mcp-server==0.5.1"
      ]
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22redis-mcp-server-local%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22redis-mcp-server%3D%3D0.5.1%22%5D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"redis-mcp-server-local","command":"uvx","args":["redis-mcp-server==0.5.1"]}'
```

Copilot CLI:

```shell
copilot mcp add redis-mcp-server-local -- uvx redis-mcp-server==0.5.1
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=redis-mcp-server-local&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJyZWRpcy1tY3Atc2VydmVyPT0wLjUuMSJdfQ%3D%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "redis-mcp-server-local": {
      "command": "uvx",
      "args": [
        "redis-mcp-server==0.5.1"
      ]
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add redis-mcp-server-local -- uvx redis-mcp-server==0.5.1
```

### Codex

Run in your terminal:

```shell
codex mcp add redis-mcp-server-local -- uvx redis-mcp-server==0.5.1
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "redis-mcp-server-local": {
      "command": "uvx",
      "args": [
        "redis-mcp-server==0.5.1"
      ]
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add redis-mcp-server-local uvx redis-mcp-server==0.5.1
```

### OpenClaw

In a terminal: Run openclaw mcp add redis-mcp-server-local --command uvx, with --arg before each argument (redis-mcp-server==0.5.1) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add redis-mcp-server-local -- uvx redis-mcp-server==0.5.1
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "redis-mcp-server-local": {
      "command": "uvx",
      "args": [
        "redis-mcp-server==0.5.1"
      ]
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).