diff --git a/.changeset/voltagent-memory-readme.md b/.changeset/voltagent-memory-readme.md
new file mode 100644
index 000000000..29a89bb60
--- /dev/null
+++ b/.changeset/voltagent-memory-readme.md
@@ -0,0 +1,5 @@
+---
+"@voltagent/voltagent-memory": patch
+---
+
+Add README documentation
diff --git a/packages/voltagent-memory/README.md b/packages/voltagent-memory/README.md
new file mode 100644
index 000000000..c20529d04
--- /dev/null
+++ b/packages/voltagent-memory/README.md
@@ -0,0 +1,108 @@
+
+
+
+
+
+
+AI Agent Engineering Platform
+
+
+
+
+
+
+
+[](https://github.com/voltagent/voltagent/issues)
+[](https://github.com/voltagent/voltagent/pulls)
+[](https://opensource.org/licenses/MIT)
+[](https://www.npmjs.com/package/@voltagent/voltagent-memory)
+[](https://www.npmjs.com/package/@voltagent/voltagent-memory)
+[](https://s.voltagent.dev/discord)
+
+
+
+## @voltagent/voltagent-memory
+
+VoltAgent's managed memory adapter, backed by the VoltOps API. `ManagedMemoryAdapter` stores conversations, messages, working memory, and workflow state without you having to provision or operate a database, and `ManagedMemoryVectorAdapter` provides managed vector storage for RAG/retriever use cases.
+
+---
+
+## Install
+
+```bash
+npm install @voltagent/voltagent-memory
+# or
+yarn add @voltagent/voltagent-memory
+# or
+pnpm add @voltagent/voltagent-memory
+```
+
+## Setup
+
+Managed memory requires a VoltOps project. Set your keys as environment variables, or pass a `voltOpsClient` explicitly:
+
+```bash
+VOLTAGENT_PUBLIC_KEY=...
+VOLTAGENT_SECRET_KEY=...
+```
+
+## Usage
+
+```typescript
+import { Agent, Memory } from "@voltagent/core";
+import { ManagedMemoryAdapter } from "@voltagent/voltagent-memory";
+import { openai } from "@ai-sdk/openai";
+
+const memory = new Memory({
+ storage: new ManagedMemoryAdapter({
+ databaseName: "my-database",
+ // or: databaseId: "db_123"
+ }),
+});
+
+const agent = new Agent({
+ name: "my-agent",
+ instructions: "A helpful assistant",
+ model: openai("gpt-4o-mini"),
+ memory,
+});
+```
+
+### Managed Memory Options
+
+| Option | Type | Default | Description |
+| --------------- | --------------- | ------- | --------------------------------------------------------------------- |
+| `databaseId` | `string` | — | Select a managed database by ID |
+| `databaseName` | `string` | — | Select a managed database by name (used if `databaseId` is not set) |
+| `voltOpsClient` | `VoltOpsClient` | — | Explicit VoltOps client; falls back to the globally registered client |
+| `debug` | `boolean` | `false` | Enable debug logging |
+
+Both `databaseId` and `databaseName` are optional individually, but at least one must be provided. If neither is given, `initialize()` throws an error because `findTargetDatabase()` cannot locate a target database and returns `undefined`.
+
+## Vector Adapter
+
+```typescript
+import { ManagedMemoryVectorAdapter } from "@voltagent/voltagent-memory";
+
+const vectorStore = new ManagedMemoryVectorAdapter({
+ databaseName: "my-database",
+});
+```
+
+`ManagedMemoryVectorAdapter` accepts the same options as `ManagedMemoryAdapter` above.
+
+## Documentation
+
+- [VoltAgent Documentation](https://voltagent.dev/docs/)
+- [Managed Memory](https://voltagent.dev/docs/agents/memory/managed-memory)
+- [Memory Overview](https://voltagent.dev/docs/agents/memory/overview/)
+
+## License
+
+Licensed under the MIT License, Copyright © 2026-present VoltAgent.