OAKOAK/memory
Dashboard
DocumentationReference
OAK.memory

MCP tool reference

The cloud MCP endpoint exposes tools for store discovery, retrieval and memory changes. Your connection supplies the account and store context.

Read and discover

Call currentMemoryStore to verify the selected store and role. listMemoryStores discovers stores you can access. getMemoryPolicy reads the selected store’s policy. listMemories browses saved records, while recallMemory performs semantic search. The example below shows a tool name and arguments, not a complete HTTP request.

Tool invocation example
{
  "name": "recallMemory",
  "arguments": {
    "query": "Project architecture decisions",
    "limit": 10
  }
}
ToolPurpose
currentMemoryStoreSelected store, role and recording identity
listMemoryStoresStores accessible to this account
getMemoryPolicySelected store policy
listMemoriesBrowse stored memories
recallMemorySemantic retrieval; query up to 4,000 characters, limit 1–50 (default 10)

Create, update and delete

Use createMemory for a new fact, updateMemory when an existing fact changes, and deleteMemory to remove a known record. Search before creating to avoid duplicates. Memory content is limited to 4,000 characters, and a create request can reference up to 32 existing related-memory UUIDs. Do not supply an account or store ID: the server derives them from the authenticated connection.

Tool invocation example
{
  "name": "createMemory",
  "arguments": {
    "content": "The project uses PostgreSQL for persistent storage."
  }
}
Documentation

Persistent memory for your AI workflow. Start with a private store, connect Claude Code, and carry useful context from one session to the next.

Quickstart

Create a store, connect your assistant and save your first memory. The cloud service runs the database for you.

Core concepts

Understand memories, stores and retrieval before connecting them to a longer workflow.

Connect ChatGPT or Claude

In your app’s custom MCP or connector settings, add https://www.openaikits.com/api/mcp and choose OAuth. Sign in to OAK, choose a store and approve access. You return to your app automatically. Automatic registration needs no API key, client ID or secret.

Connect Claude Code

Use a personal key and store profile to connect the OAK.memory plugin to hosted memory.

Share a memory store

Give collaborators access to a shared context while keeping each account’s identity and usage separate.

MCP tool reference

The cloud MCP endpoint exposes tools for store discovery, retrieval and memory changes. Your connection supplies the account and store context.

Usage tiers and limits

Understand which limits your account shares, how operation credits work and what to do when a request is refused.

Troubleshooting

Identify whether an issue comes from your connection, permissions, usage or the embedding service.

Local plugin setup

Run memory on your own machine instead of using a hosted cloud store. This has a separate database and setup process.

Guides

Practical paths for using memory in a personal project, a shared team store or a workflow with several agents.