Skip to main content

Memories

Memories are short, atomic facts, such as definitions, preferences, and answers to recurring questions, captured by your team while working with an AI assistant, or added manually. Unlike Articles, Memories aren’t meant to be full pages. They’re quick, reusable pieces of context. The create_context_memory MCP tool can create a memory when you ask an assistant to remember something. MCP company-context search currently retrieves only shared knowledge pills extracted from uploaded files; it does not retrieve manually created or remembered Memories.

Create a Memory

To create a memory, follow these steps:
  1. From the left navigation bar, navigate to Context Center > Memories. Access memories
  2. Select Add Memory. Add Memory dialog
  3. In the Add Memory dialog, fill in the following details:
    • Title: An optional label for the memory.
    • Memory: Required. Describe what the assistant should remember, written in plain markdown. Click Preview to see how the formatted content will look. Create Memory stays disabled until this field has content.
    • Type: Optional. Choose the kind of memory:
      • FAQ: A recurring question and its answer.
      • Note: A general fact worth remembering.
      • Preference: A personal preference for how the assistant should behave for you.
      • Runbook: A step-by-step procedure.
      • Use Case: A specific scenario and how to handle it.
    • Linked Data Assets: Optionally link the memory to one or more data assets using Link an Asset.
    • Metadata:
      • Visibility: Choose who can see the memory. Defaults to Shared.
        • Shared: Visible to people or teams in the memory’s shared-with list. The Add Memory dialog currently doesn’t let you add people or teams to that list.
        • Entity: Visible organization-wide to people with access to the Context Memory resource. It isn’t limited to people viewing a linked data asset.
        • Private: Visible only to you.
      • Tags: Optionally tag the memory using Add Tag.
    Add Memory dialog fields
  4. Click Create Memory to save it.
An AI assistant can also create memories on its own during a conversation, for example when you ask it to remember a preference.

View and Manage Memories

The Memories page shows:
  • Search bar: Search memories by their content.
  • Summary cards: Total Memories and Created by me, each showing a count.
  • Filters: Switch between All and Created by me, or narrow the list by All Assets or All Author.
  • Sort: Order the list, for example by Updated by.
  • Memory list: Each row shows the author’s name and avatar, when it was last updated, the memory’s title, its content, and how many times it’s been Cited, that is, how often it’s actually been used to answer a question.
  • Row actions:
    • Copy link: Copy the memory URL.
    • Edit: Open the memory to change its title, content, type, visibility, tags, or linked assets.
    • Delete: Open the menu and select Delete to remove the memory. Manage Memories

Control Access to Memories with Roles and Policies

Memories are a governed resource in OpenMetadata’s role-based access control system, listed as Context Memory under the Misc resource category. Admins control who can view, create, edit, or delete memories platform-wide by adding a rule to a policy that targets the Context Memory resource.
  1. Click the Profile icon and navigate to Settings > Access Control > Policies.
  2. Open an existing policy and click Add Rule.
  3. Fill in the following details:
    • Name: Enter a unique rule name.
    • Description (optional): Add a note explaining what this rule does and why, so other admins reviewing the policy later understand its intent.
    • Resources: Select Context Memory.
    • Operations: Set the actions to allow or deny, for example All to cover every operation, or a specific set such as Create and EditAll.
    • Effect: Select from Allow or Deny.
    • Condition (optional): A CEL expression to scope the rule further, such as restricting it to a domain.
  4. Click Save, then attach it to the roles that should have this access. Context Memory resource in a Roles and Policies rule
You can also add this rule while creating a new policy, instead of adding it to an existing one. This RBAC layer is separate from a memory’s own Visibility setting (see Create a Memory): RBAC controls whether a role can interact with memories as a resource type at all, while Visibility and sharing control who can see one specific memory once it exists. Seeing a memory requires both: RBAC permission on Context Memory, and visibility into that memory, either as its owner, through its shared-with list, or because it uses Entity visibility. See Roles and Policies for how rules, policies, and roles fit together, and Resource Scope and Operations Reference for the full list of operations available on Context Memory and other resources.