---
title: "ChatGPT"
description: "Install Basic Memory Cloud from ChatGPT's Plugin directory and use your knowledge base in chat."
canonical_url: "https://docs.basicmemory.com/integrations/chatgpt"
---
# ChatGPT

> Install Basic Memory Cloud from ChatGPT's Plugin directory and use your knowledge base in chat.

Basic Memory Cloud is available in ChatGPT's **Plugin directory**. Connecting the published plugin is the recommended setup; it does not require Developer mode or a server URL. Since ChatGPT connects to the hosted service, **Basic Memory Cloud is required**.

## Install from the Plugin directory

<docs-video alt="Installing the Basic Memory Cloud plugin in ChatGPT and using it in a chat" poster="/videos/posters/docs-connect-chatgpt.png" src="https://docs.basicmemory.com/videos/docs-connect-chatgpt.mp4">



</docs-video>

<steps>

### Open Basic Memory Cloud

Open [Basic Memory Cloud in ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6a49590bf6348191a16c0b87ca6b01b4). You can also select **Plugins** in the ChatGPT sidebar and search for **Basic Memory Cloud**.

![Basic Memory Cloud in ChatGPT's Plugin directory](https://docs.basicmemory.com/screenshots/chatgpt/plugin-directory-basic-memory-cloud.jpg)

### Connect your account

Select **Connect** and complete the Basic Memory authorization flow. If you do not have an account yet, you can create one during sign-in.

### Start a chat

Select **Try in chat** from the plugin page. In an existing conversation, type `@` and choose **Basic Memory Cloud**, or select **+ → More → Basic Memory Cloud**.

### Verify the connection

Ask:

```text
List my Basic Memory projects.
```

</steps>

<tip>

See the [Cloud Guide](https://docs.basicmemory.com/cloud/cloud-guide) for account setup, the web app, and sync options.

</tip>

## Manual setup with custom MCP

Use this only when you need a custom MCP connection or cannot use the published plugin. Plugin-directory users can skip Developer mode entirely.

<steps>

### Create a Basic Memory account

Sign up at [basicmemory.com](https://basicmemory.com/?utm_source=docs&utm_medium=docs&utm_campaign=chatgpt).

### Enable Developer mode

In ChatGPT, go to **Settings → Apps & Connectors → Advanced settings** and enable **Developer mode**.

### Add the MCP server

Select **Create** and enter:

- **Name**: Basic Memory
- **Server URL**: `https://cloud.basicmemory.com/mcp`

### Authenticate and enable

Complete the OAuth flow, then select Basic Memory from the app or MCP selector in your conversation.

</steps>

## Try It

Once connected, ask ChatGPT to work with your knowledge base:

- **Search**: "Find my notes about authentication design"
- **Retrieve**: "Show me the full contents of my API documentation"
- **Semantic search**: "Find notes conceptually related to microservice architecture" — the default `search` tool already searches semantically (hybrid mode)

ChatGPT will call the appropriate tools behind the scenes, searching and fetching documents as needed.

## Use the interactive Basic Memory app

When you ask to open or browse Basic Memory, ChatGPT can display the **Pocketbook** directly in the conversation. From there you can switch projects and folders, browse or search notes, explore the graph, follow wiki links, edit notes, toggle tasks, and work through comments and suggested edits.

<docs-video alt="Pocketbook inside a ChatGPT conversation" poster="/videos/posters/docs-pocketbook.png" src="https://docs.basicmemory.com/videos/docs-pocketbook.mp4">



</docs-video>

Try:

```text
Open Basic Memory search for quarterly planning.
```

If you only ask a question about your notes, ChatGPT uses the normal search and read tools instead of opening the interface. See [Pocketbook](https://docs.basicmemory.com/cloud/mcp-app) for the full workflow.

## Important Notes

<warning>

Plugin availability can depend on your ChatGPT plan, region, workspace settings, and role. If **Connect** is unavailable or marked **Disabled by admin**, ask your workspace admin to enable the plugin and its Basic Memory Cloud app.

</warning>

<note>

**Plugin and app terminology**

ChatGPT calls the directory listing a **plugin**. The plugin contains the **Basic Memory Cloud app**, which connects ChatGPT to your knowledge base. You may see both terms in ChatGPT's settings.

</note>

## Troubleshooting

**Plugin not found** — Open the [direct plugin page](https://chatgpt.com/plugins/plugin_asdk_app_6a49590bf6348191a16c0b87ca6b01b4) or search the Plugin directory for the exact name **Basic Memory Cloud**.

**Connect is disabled** — Your plan, region, role, or workspace policy may restrict the app. In a managed workspace, ask an admin to review **Workspace settings → Plugins** and the underlying app in **Workspace settings → Apps**.

**Authentication errors** — Disconnect and reconnect the Basic Memory Cloud app, then complete the OAuth flow again. If you used the manual custom MCP flow, remove and re-add that server.

**Basic Memory is not used in a chat** — Type `@Basic Memory Cloud` or select **+ → More → Basic Memory Cloud**. Starting from **Try in chat** on the plugin page also creates a conversation with it enabled.

**No results returned** — Make sure your Basic Memory Cloud account has synced content. Check your project at [app.basicmemory.com](https://app.basicmemory.com).

For ChatGPT's current platform instructions, see [Plugins in ChatGPT and Codex](https://help.openai.com/en/articles/20001256-plugins-in-chatgpt-and-codex).

## Next Steps

<card-group>
<card icon="i-lucide-cloud" title="Cloud Setup Guide" to="https://docs.basicmemory.com/cloud/cloud-guide">

Detailed cloud configuration and sync options.

</card>

<card icon="i-lucide-wrench" title="MCP Tools Reference" to="https://docs.basicmemory.com/reference/mcp-tools-reference">

Complete documentation for every MCP tool.

</card>

<card icon="i-lucide-panels-top-left" title="Pocketbook" to="https://docs.basicmemory.com/cloud/mcp-app">

Browse and edit Basic Memory inside a compatible conversation.

</card>

<card icon="i-lucide-message-square" title="Claude Desktop" to="https://docs.basicmemory.com/integrations/claude-desktop">

Full local and remote MCP integration.

</card>
</card-group>


## Sitemap

See the full [sitemap](https://docs.basicmemory.com/sitemap.md) for all pages.
