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
getsethgetallscan_keysjson_getvector_search_hash
Tool names are upstream examples. The server's live tool list can differ.
Related 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.