Upstash Redis

by Upstash

v0.1.1

MIT

Repository Docs npm

Databases & Data

redisserverlesscacheupstash

Summary

Run Redis commands against Upstash's serverless Redis over HTTP, with documentation search built in.

Features

Run Redis commands over HTTP against Upstash
Search Upstash documentation from the same server
Works from serverless and edge environments

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "Upstash Redis" tools will be available.

{
  "mcpServers": {
    "upstash-redis": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/redis-mcp"
      ],
      "env": {
        "UPSTASH_REDIS_REST_URL": "https://your-db.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add upstash-redis -e UPSTASH_REDIS_REST_URL=https://your-db.upstash.io -e UPSTASH_REDIS_REST_TOKEN=your-token -- npx -y @upstash/redis-mcp

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "upstash-redis": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/redis-mcp"
      ],
      "env": {
        "UPSTASH_REDIS_REST_URL": "https://your-db.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "your-token"
      }
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "@upstash/redis-mcp"
  ],
  "env": {
    "UPSTASH_REDIS_REST_URL": "https://your-db.upstash.io",
    "UPSTASH_REDIS_REST_TOKEN": "your-token"
  }
}

Windsurf

{
  "command": "npx",
  "args": [
    "-y",
    "@upstash/redis-mcp"
  ],
  "env": {
    "UPSTASH_REDIS_REST_URL": "https://your-db.upstash.io",
    "UPSTASH_REDIS_REST_TOKEN": "your-token"
  }
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "@upstash/redis-mcp"
  ],
  "env": {
    "UPSTASH_REDIS_REST_URL": "https://your-db.upstash.io",
    "UPSTASH_REDIS_REST_TOKEN": "your-token"
  }
}

Description

Upstash's MCP server connects an assistant to a serverless Redis database over HTTP, which means it works from environments where a persistent TCP connection is not possible.

What it provides

Redis command execution across the standard data types — strings, hashes, lists, sets, sorted sets — through Upstash's REST API
Key inspection for exploring what is actually stored, which is the usual reason to open a Redis client in the first place
Documentation search over Upstash's docs, so an assistant writing Upstash code works from current reference material

Why HTTP-based Redis matters here

Upstash exposes Redis over HTTP specifically so it can be used from serverless functions and edge runtimes. That same property makes it straightforward to reach from an MCP server without connection pooling or network access to a private VPC.

Typical uses

Debugging cache contents, checking rate-limit counters, inspecting session data, and clearing specific keys during development — all without leaving the assistant or opening a console.