Skip to main content
This page is for builders: it shows how to wire MemoryPlugin into a Custom GPT you create yourself, so your GPT can store and recall long-term memory. If you just want to use MemoryPlugin in ChatGPT without building anything, use the official MemoryPlugin Custom GPT instead. You add memory by importing MemoryPlugin’s OpenAPI spec as a GPT Action and pasting in a short instruction block.

​
Key concepts

Actions let a Custom GPT call external tools. You use one to connect your GPT to MemoryPlugin.

​
Setup

1

Open the GPT builder

Open the edit window for your Custom GPT (or create a new one), go to the Configure tab, and scroll down to the Actions section.Custom GPT editor showing the Configure tab
2

Create the action

The Actions section sits near the bottom of the Configure tab.Actions section in the Custom GPT editorClick Create new action, then Import from URL, and enter this URL:
https://www.memoryplugin.com/openapi.json
Create new action in the Custom GPT editor
3

Configure authentication

In the Authentication section, click the settings icon. Select API Key, then choose Bearer.Copy your auth token from Settings → Integrations in the MemoryPlugin dashboard: under Authentication Token, click Copy, then paste it into the authentication setup.MemoryPlugin dashboard showing the Authentication TokenAuthentication setup with API Key and Bearer
Your auth token is like a password to your account. Keep it confidential. If it ever leaks, click Regenerate on the same Settings → Integrations screen to invalidate the old one.
Account email independence: Your MemoryPlugin sign‑in email does not need to match the email you use on ChatGPT, Claude, TypingMind, or any other tool. Access and permissions are tied to your MemoryPlugin account (and API key when applicable), not third‑party logins.
4

Add instructions

Back in the Configure tab, find the Instructions section. Add the MemoryPlugin instructions after your existing custom instructions.Instructions section in the Custom GPT editor
VERY IMPORTANT: ALWAYS fetch all memories at the start of each chat before responding (unless explicitly instructed otherwise), so you have context about me and can help me better. Use the `GetMemoriesAndBuckets` operation to do this.

The `memory` tool allows you to persist information across conversations. Add to memory any information you want to remember. The information will appear in the context in future conversations.

- Memories are stored in "buckets"
- If you do not supply a bucket id when loading memories, all memories are loaded
- if you do supply a bucket id, only those buckets memories are loaded
- by default memories are added to the "General" bucket
- new buckets cannot be named "General"
- If you supply the bucketId when creating a new memory, it will be added to that bucket instead
- Do not guess bucket IDs, they are random
- When using bucket IDs, please make sure they are correct and are sent in the correct parameter.
- When explicitly instructed to add a memory by the user, follow the users instructions strictly.

I can use \m or +m as a shortcut to create a new memory.

- before using any tool, review the tool use instructions thoroughly
- Double-check the function schemas to make sure you are using the correct expected format.
- Make sure your tool and/or function call matches the expected format and schema
- if a JSON schema is specified, adhere to it strictly.
- Verify all your tool calls with the usage instructions in the system prompt.
5

Save and test

Click Save to save the action, then start a new conversation. The GPT should load your memories at the start of the chat.

​
What your GPT gains

Once integrated, your Custom GPT can:
  • Load memories at the start of a conversation
  • Remember information from earlier chats
  • Organize memories into buckets
  • Search memories to find what is relevant
  • Persist knowledge across conversations
  • Share memories with your other MemoryPlugin integrations

​
Best practices

Memory management

Tell your GPT which kinds of information to remember, based on what it is for.

Bucket strategy

Use separate buckets for the different contexts or topics your GPT handles.

User shortcuts

Let users know about the \m and +m shortcuts for quick memory creation.

Privacy

Be deliberate about what gets stored, and tell users what your GPT remembers.

​
Troubleshooting

Use the exact URL: https://www.memoryplugin.com/openapi.json.
Recopy your auth token from Settings → Integrations. If it still fails, click Regenerate and update the action with the new token.
Confirm your GPT instructions include the memory-loading prompt and are formatted as shown.
Make sure the instructions tell the GPT to follow the schema and format strictly.

​
Example use cases

  • Personal assistant GPT: remember preferences, schedule, and personal details.
  • Learning companion: track progress and concepts studied over time.
  • Project manager: remember project details, team info, and progress across chats.
  • Writing assistant: remember style, characters, and plot points across sessions.
  • Customer service: remember interactions, preferences, and history.

​
Next steps

Official MemoryPlugin Custom GPT

Use the ready-made GPT instead of building your own

API Reference

Explore the full MemoryPlugin API

Memory Buckets

Organize memories effectively