Skip to main content
The Upstash Redis MCP server connects your agent directly to a Redis database. It is lightweight and ships with just two tools:
  • redis_run_commands: run any Redis command (including the SEARCH.* family), as a pipeline or an atomic transaction.
  • redis_search_docs: search the Upstash Redis docs live, so the agent can look up commands and features on demand.
Find the GitHub repository here.
To manage your whole Upstash account (create databases, read QStash and Workflow logs, drive Upstash Box), use the Upstash MCP server instead.

​
Installation

Grab your database’s REST URL and token from the Upstash Console (open your Redis database and copy UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN from the REST API section), then add the server to your MCP client. To connect over TCP instead, set UPSTASH_REDIS_TCP_URL to your rediss:// connection string in place of the two REST variables. 
claude mcp add upstash-redis \
  -e UPSTASH_REDIS_REST_URL=https://YOUR_DB.upstash.io \
  -e UPSTASH_REDIS_REST_TOKEN=YOUR_REST_TOKEN \
  -- npx -y @upstash/redis-mcp
Add to Cursor
{
  "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_REST_TOKEN"
      }
    }
  }
}

{
  "servers": {
    "upstash-redis": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/redis-mcp"],
      "env": {
        "UPSTASH_REDIS_REST_URL": "https://YOUR_DB.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "YOUR_REST_TOKEN"
      }
    }
  }
}

[mcp_servers.upstash-redis]
command = "npx"
args = ["-y", "@upstash/redis-mcp"]
env = { UPSTASH_REDIS_REST_URL = "https://YOUR_DB.upstash.io", UPSTASH_REDIS_REST_TOKEN = "YOUR_REST_TOKEN" }

{
  "mcp": {
    "upstash-redis": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/redis-mcp"],
      "environment": {
        "UPSTASH_REDIS_REST_URL": "https://YOUR_DB.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "YOUR_REST_TOKEN"
      }
    }
  }
}
Any MCP-compatible client works. If yours isn’t listed, add a stdio server that runs npx -y @upstash/redis-mcp with the two env vars above.