Redis Agent Memory MCP server
Commit Nov 12, 2026Gives Google ADK agents durable Redis sessions, semantic long-term memory, vector search tools, and semantic caching.
Also known as redis-developer/adk-redis
- Stars
- 32
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 12, 2026
- License
- Apache-2.0
What is Redis Agent Memory MCP?
Redis Agent Memory gives Google ADK agents durable Redis sessions, semantic long-term memory, vector search tools, and semantic caching.
Summary generated from the project's README
About Redis Agent Memory MCP server
Providing Google ADK agents with durable memory and advanced search capabilities is what adk-redis accomplishes. It serves as a specialized Redis layer designed for developers building agents with the Google Agent Development Kit, allowing them to implement long-term semantic memory and persistent conversation sessions.
Users can integrate this server into their local Python environments using pip, requiring Python 3.10 or higher and Redis 8.4. The setup supports two distinct backends: a managed redis-agent-memory option that requires an api_key and store_id, or an opensource-agent-memory option for self-hosted Agent Memory Server deployments.
Beyond basic storage, the package provides specialized tools for vector, hybrid, range, text, and SQL search via RedisVL. It also includes semantic caching providers to reduce redundant LLM calls and MCP toolset helpers like search-records and upsert-records for streamlined record management.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableredis-developer/adk-redis is public and reachablegithub.com/redis-developer/adk-redis ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/redis-developer/adk-redis ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubPyPI • Documentation • Examples • Redis Agent Memory • RedisVL
adk-redis is the Redis layer for Google ADK agents. It implements ADK's BaseMemoryService, BaseSessionService, and BaseTool interfaces against Redis, Redis Vector Library, Redis Agent Memory. It also ships MCP toolset helpers and semantic-cache providers.
| Surface | What you get | Backed by |
|---|---|---|
| Sessions | BaseSessionService with durable conversation state |
Redis Agent Memory or Agent Memory Server |
| Long-term memory | BaseMemoryService with semantic search |
Redis Agent Memory or Agent Memory Server |
| Memory tools | LLM-controlled memory CRUD operations | Redis Agent Memory or Agent Memory Server |
| Search tools | Vector, hybrid, range, text, and SQL search as BaseTool subclasses |
RedisVL |
| MCP search | search-records / upsert-records via ADK's native McpToolset |
rvl mcp server |
| Semantic cache | Skip repeat LLM calls by semantic similarity | RedisVL or Redis LangCache |
Installation
pip install adk-redis
Optional extras:
pip install 'adk-redis[memory]' # sessions + long-term memory services
pip install 'adk-redis[search]' # RedisVL-backed search tools
pip install 'adk-redis[sql]' # RedisSQLSearchTool
pip install 'adk-redis[langcache]' # managed semantic cache provider
pip install 'adk-redis[all]' # everything above
Memory backends are selected with backend:
| Backend | Use when | Client |
|---|---|---|
redis-agent-memory |
You want Redis Agent Memory managed by Redis or the Redis Agent Memory data plane | redis-agent-memory |
opensource-agent-memory |
You want the open source self-hosted Agent Memory Server | agent-memory-client |
The memory extra installs redis-agent-memory>=0.2.0,<0.3 for the managed
backend.
Quick start
Prerequisites: Python 3.10+, Redis 8.4+, and one memory backend. See the Quickstart for full setup steps.
from google.adk import Agent
from google.adk.runners import Runner
from adk_redis import (
RedisLongTermMemoryService,
RedisLongTermMemoryServiceConfig,
RedisSessionMemoryService,
RedisSessionMemoryServiceConfig,
)
session_service = RedisSessionMemoryService(
config=RedisSessionMemoryServiceConfig(
backend="redis-agent-memory",
api_base_url="http://localhost:8088",
api_key="...",
store_id="...",
default_namespace="my_app",
),
)
memory_service = RedisLongTermMemoryService(
config=RedisLongTermMemoryServiceConfig(
backend="redis-agent-memory",
api_base_url="http://localhost:8088",
api_key="...",
store_id="...",
default_namespace="my_app",
),
)
agent = Agent(
model="gemini-2.5-flash",
name="memory_agent",
instruction="You are a helpful assistant with long-term memory.",
)
runner = Runner(
app_name="my_app",
agent=agent,
session_service=session_service,
memory_service=memory_service,
)
For the open source self-hosted Agent Memory Server, set
backend="opensource-agent-memory" and omit api_key and store_id unless your
server requires them.
→ More examples: search tools, MCP search, semantic caching
Examples
Each example ships with a README and .env.example. Memory and session
examples that register services through get_service_registry() run via
python main.py; tools-only and search examples run via adk web. See each
example's README and the Examples index for the runner and backend each uses.
| Category | Examples |
|---|---|
| Memory and sessions | managed_memory_quickstart · simple_redis_memory · travel_agent_memory_hybrid · travel_agent_memory_tools · fitness_coach_mcp |
| Search | redis_search_tools · redis_sql_search · redisvl_mcp_search |
| Caching | semantic_cache · langcache_cache |
Development
git clone https://github.com/redis-developer/adk-redis.git
cd adk-redis
make dev # install with all extras + dev deps
make check # format, lint, type-check, and test
See CONTRIBUTING.md for the full guide.
Contributing
Open an issue or submit a PR following CONTRIBUTING.md.
License
Apache 2.0. See LICENSE.
Links
- Documentation: concepts, how-to guides, API reference
- Google ADK · Agent Memory Server · RedisVL · Redis LangCache
- ADK + Redis on redis.io
Redis Agent Memory MCP questions
What does adk-redis add to Google ADK agents?
It implements ADK's session, memory, and tool interfaces against Redis so agents get durable conversation state, long-term memory, and search tools.
How do I install adk-redis?
Install the base package with pip and add extras for memory, search, SQL, or LangCache as needed.
Which memory backends can I use?
You can use Redis Agent Memory (managed) or the open source self-hosted Agent Memory Server, selected with the backend option.
Does adk-redis provide MCP search tools?
Yes, it offers search-records and upsert-records through ADK's native McpToolset against the rvl mcp server.
Can adk-redis cache repeated LLM calls?
Yes, semantic caching skips repeat LLM calls based on semantic similarity using RedisVL or Redis LangCache.