Unlock daily dreams Boost your Brain Glow by up to +14 pts/night. Upgrade →
Brain Glow 84 🔥
v0.1 MIT License MCP Compatible 4 Importers
Open Standard · Published by REM Labs

Open Agent Memory
Specification

OAMS v0.1 — The open standard for agent memory interchange. Import from anywhere. Export to everywhere. Become the de facto memory protocol.

Like HTTP for the web · Like npm for packages · Published by remlabs.ai

The Problem

Agent memory is siloed.

Memories in Mem0 can't be read by Zep. Memories in Letta can't be exported to REM Labs. Every system invents its own format, its own field names, its own semantics. When you migrate, you lose everything. No standard exists — until now.

The Solution

OAMS defines the open interchange format.

Like HTTP for the web, like npm for packages — whoever defines the standard shapes the ecosystem. OAMS gives every agent memory system a common language: portable objects, typed schemas, one-click importers, and a public validation endpoint anyone can use for free.

Object Schemas

Five canonical objects.

Every OAMS-compatible system speaks these five shapes. Interoperable by design.

Memory Object core
{ "id": "mem_abc123", "namespace": "default", "key": "team-error-handling-pattern", "value": "Services A, C, F use exponential backoff...", "tags": ["engineering", "patterns", "dream-synthesis"], "created": 1775000000000, "source": "dream_engine", "valence": 0.3, "type": "project" }
Dream Output dream engine
{ "dreamId": "drm_xyz789", "stages": ["synthesize", "pattern_extract", ], "insights": [ "Error patterns diverge in 3 clusters", "Standardize on pattern X" ], "creativeLeaps": ["What-if: Apply auth pattern → +37% velocity"], "predictiveLeaps": ["Anticipated: service coupling — audit"], "remScore": 87, "biota_iterations": 3, "convergence": 0.92 }
BiOtA Metadata synthesis
{ "iterations": 3, "convergenceScore": 0.92, "temperatureCurve": [ 0.70, 0.65, 0.70, 0.75, 0.60, 0.65, 0.70, 1.15, 0.35, 0.40 ], "swrClusters": 14 }
Context Pack contextdream
{ "pack_id": "ctx_abc", "gist": "Compressed context...", "creative_leaps": [ "Cross-domain synthesis: ..." ], "raw_tokens": 8192, "tokens_saved": 4915, "savings_pct": 60.0 }
Knowledge Graph Node dreamhive
{ "node_id": "node_xyz", "content": "Microservice error-handling schema", "schema_type": "pattern", "consolidation_stage": 7, "biota_iteration": 2, "hive_namespace": "engineering-hive" }

One-Click Importers

Import your memories in 60 seconds.

Three live importers. Paste your API response — OAMS normalizes everything automatically.

Import from Mem0
POST /v1/oams/import/mem0

Normalizes Mem0 memory format to OAMS. Import in under 60 seconds.

POST /v1/oams/import/mem0 Authorization: Bearer YOUR_KEY Content-Type: application/json {"memories": [...]} # from Mem0 GET /v1/memories/
Import from Zep
POST /v1/oams/import/zep

Converts Zep facts and edges to OAMS Memory Objects. Graph relationships preserved.

POST /v1/oams/import/zep Authorization: Bearer YOUR_KEY { "facts": [...], "edges": [...] } # from Zep GET /api/v2/users/{id}/memory
Import from Letta
POST /v1/oams/import/letta

Maps Letta agent memory blocks to OAMS. Core, archival, and recall memory supported.

POST /v1/oams/import/letta Authorization: Bearer YOUR_KEY { "blocks": [...] } # from Letta GET /v1/agents/{id}/memory/blocks

API Reference

Eight endpoints. Two public.

The spec, schema, and validator are fully public — no auth required. Import and export endpoints require an API key.

Method Endpoint Description Auth
GET /v1/oams/spec Full OAMS specification public
GET /v1/oams/schema JSON Schema for all object types public
POST /v1/oams/validate Validate memory objects against spec public
POST /v1/oams/import/mem0 Import and normalize from Mem0 format API key
POST /v1/oams/import/zep Import and normalize from Zep format API key
POST /v1/oams/import/letta Import and normalize from Letta blocks API key
POST /v1/oams/import/json Import raw OAMS JSON directly API key
GET /v1/oams/export Export all your memories as OAMS JSON API key

Live Validation

Try it now —
no auth required.

The /v1/oams/validate endpoint is fully public. Drop in any memory object and get instant schema validation with detailed error messages.

Validates required fields: id, namespace, key, value
Type-checks optional fields: valence, tags, source
Returns {"ok":true,"valid":true,"count":1} on pass
Returns detailed error paths on failure
terminal
curl -s https://slopshop-production.up.railway.app/v1/oams/validate \ -H "Content-Type: application/json" \ -d '{ "id": "test", "namespace": "default", "key": "my-key", "value": "hello" }' # Response: { "ok": true, "valid": true, "count": 1 }

Get Involved

Help shape the standard.

OAMS is open. The more systems that adopt it, the stronger the standard becomes.

01
Implement OAMS

Build OAMS support into your agent memory system. Implement the five schemas and at least one endpoint. We'll add you to the certified compatible list and link your project.

Get certified →
02
Propose to MCP

We're submitting OAMS as a formal memory extension proposal to the Model Context Protocol community. Add your voice. The more signatories, the faster it becomes an adopted extension.

Join the conversation →
03
Contribute

Submit new importers for other memory systems — LangChain, Supermemory, custom databases. Contributors receive a 70/30 revenue share on any paid tooling built on their importer.

Submit a PR →

Start now

Start importing your memories
in 60 seconds.

Free to validate. Free to import. One API key, portable forever.

Published by remlabs.ai · MIT License · No vendor lock-in