How to Install Redis MCP in Windsurf
Connect AI agents to Redis — get, set, and manage cached data, queues, and pub/sub channels
What Redis MCP does
Full Redis access for AI agents — work with all Redis data structures, manage expiration, inspect keys, and handle real-time pub/sub messaging through natural language. Features: - String operations: GET, SET, MGET, MSET with TTL support - List operations: LPUSH, RPOP, LRANGE — build queues and stacks - Hash operations: HSET, HGET, HGETALL for structured data - Set operations: SADD, SMEMBERS, SINTER for unique collections - Sorted sets: ZADD, ZRANGE for leaderboards and time-series - Key management: KEYS, SCAN, TTL, PERSIST, DEL - Pub/Sub: subscribe to channels, publish messages - Transactions: MULTI/EXEC for atomic operations - Lua scripting support Works with Redis, Redis Cluster, Redis Sentinel, and Redis-compatible services (Upstash, AWS ElastiCache, Azure Cache for Redis). Ideal for AI agents managing application state, session data, rate limits, and real-time queues.
Installation steps
- 1Copy the config below
- 2Open ~/.codeium/windsurf/mcp_config.json
- 3Paste inside "mcpServers": {}
- 4Restart Windsurf
Configuration
File location: ~/.codeium/windsurf/mcp_config.json
{
"redisMcp": {
"command": "uvx",
"args": [
"mcp-server-redis"
],
"env": {
"REDIS_URL": "redis://localhost:6379"
}
}
}Install in other clients
For maintainers
If you maintain Redis MCP, add this badge to your README to show it's verified on CuratedMCP:
[](https://curatedmcp.com/marketplace/redis-mcp)