---
title: "Pocketbook (Interactive MCP App)"
description: "Browse, search, graph, read, review, and edit Basic Memory from a compatible MCP conversation."
canonical_url: "https://docs.basicmemory.com/cloud/mcp-app"
---
# Pocketbook (Interactive MCP App)

> Browse, search, graph, read, review, and edit Basic Memory from a compatible MCP conversation.

Basic Memory Cloud includes **Pocketbook**, its Interactive MCP App, inside compatible AI clients. It brings a focused version of your workspace into the conversation, so you can browse notes, set a writing location, or make a quick edit without switching to a separate browser tab.

The app is part of the hosted Cloud connector at `https://cloud.basicmemory.com/mcp`; there is no second server or separate installation.

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



</docs-video>

<note>

Pocketbooks are currently supported in:

- **ChatGPT** — web and desktop
- **Claude** — web and desktop

Other MCP clients can still use the normal Basic Memory tools, and your assistant can link you to the full web app.

</note>

## Open Basic Memory in a conversation

Ask naturally for a visual or interactive view:

```text
Open Basic Memory.
Show my project notes.
Open my note about API design.
Let me browse the research folder.
Open Basic Memory search for authentication.
Show the knowledge graph around my architecture note.
```

Your assistant calls `open_basic_memory` and opens the requested view. The default workspace and project resolve automatically, so you do not need to list or choose a project first unless you want a different location.

<theme-image alt="The Pocketbook open to the Notes gallery inside an AI conversation" dark="/screenshots/mcp-app/mcp-app-open-dark.png" light="/screenshots/mcp-app/mcp-app-open-light.png">



</theme-image>

## Expand the app to full screen

When your AI client supports full-screen MCP Apps, the diagonal-arrow **Expand** action appears in the app header beside the link to the full Basic Memory web app.

<theme-image alt="The Expand action in Pocketbook header" dark="/screenshots/mcp-app/mcp-app-expand-control-dark.png" light="/screenshots/mcp-app/mcp-app-expand-control-light.png">



</theme-image>

Choose **Expand** to move from the compact conversation card into a larger workspace. Full-screen mode keeps the project or folder picker, **Notes**, **Search**, **Graph**, the active writing-location control, and the full web-app link together while giving note cards, editors, and graphs more room.

The exact full-screen frame is controlled by the AI client. Use its close or return control to go back to the conversation.

<theme-image alt="The Pocketbook expanded to a full-screen workspace in an AI client" dark="/screenshots/mcp-app/mcp-app-fullscreen-dark.png" light="/screenshots/mcp-app/mcp-app-fullscreen-light.png">



</theme-image>

## Choose where new notes go

The **Notes** view is both a browser and a location picker. Use the breadcrumb at the top to switch workspaces, projects, and folders. Folder cards show their note counts, note cards open in place, and **Load more** pages through longer directories. The external-link action opens the current location in the full Basic Memory web app.

<theme-image alt="The Use this folder button before a writing location is selected in Pocketbook" dark="/screenshots/mcp-app/mcp-app-use-folder-dark.png" light="/screenshots/mcp-app/mcp-app-use-folder-light.png">



</theme-image>

Choose **Use this folder** to make the current workspace, project, and directory the active writing location for the conversation. The app marks it as **Active folder**, and the copy action lets you reuse its Basic Memory location elsewhere.

<theme-image alt="A folder selected as the active writing location in Pocketbook" dark="/screenshots/mcp-app/mcp-app-active-folder-dark.png" light="/screenshots/mcp-app/mcp-app-active-folder-light.png">



</theme-image>

The app sends the location into the conversation and asks the assistant to write new notes there until you choose another folder. The assistant can then keep the workspace, project, and directory attached to later Basic Memory calls instead of asking you to select them again.

<theme-image alt="An assistant confirming the active Basic Memory workspace, project, and folder" dark="/screenshots/mcp-app/mcp-app-folder-confirmed-dark.png" light="/screenshots/mcp-app/mcp-app-folder-confirmed-light.png">



</theme-image>

## Read and reuse a note

Open a note from **Notes**, **Search**, a wiki link, or the knowledge graph. The reader renders Basic Memory Markdown, including wiki links, task lists, tables, syntax-highlighted code, Mermaid diagrams, observations, relations, and frontmatter.

From the reader you can:

- Toggle task checkboxes
- Refresh the note or inspect its frontmatter
- See how many review threads remain unresolved
- Copy a note link or open the note in the full web app
- Click the note title to use the note in the conversation
- Switch to **Edit** without leaving the conversation

<theme-image alt="A Basic Memory note rendered inside the MCP App reader" dark="/screenshots/mcp-app/mcp-app-note-reader-dark.png" light="/screenshots/mcp-app/mcp-app-note-reader-light.png">



</theme-image>

### Add a note to your prompt

In the Notes gallery, hover over a note card and choose **Use note in conversation**. The app prepares a prompt that tells the assistant to use that note in the current conversation thread.

<theme-image alt="The Use note in conversation action on a note card in Pocketbook gallery" dark="/screenshots/mcp-app/mcp-app-use-note-gallery-dark.png" light="/screenshots/mcp-app/mcp-app-use-note-gallery-light.png">



</theme-image>

You can also open the note and click its title in the reader to use it in the conversation.

<theme-image alt="The clickable note title in the full Pocketbook reader header" dark="/screenshots/mcp-app/mcp-app-use-note-title-dark.png" light="/screenshots/mcp-app/mcp-app-use-note-title-light.png">



</theme-image>

The prompt identifies the note by workspace, project, and permalink, so the assistant can read the right note and use it as context. You can add your question or instructions before sending it.

<theme-image alt="A conversation prompt prepared with a Basic Memory note's workspace, project, and permalink" dark="/screenshots/mcp-app/mcp-app-note-prompt-dark.png" light="/screenshots/mcp-app/mcp-app-note-prompt-light.png">



</theme-image>

## Search across your notes

Open **Search**, enter a query, and choose whether to search the current project or all projects you can access. Results show matching excerpts and their locations; select one to open it in the reader without leaving the app.

<theme-image alt="Search results in Pocketbook" dark="/screenshots/mcp-app/mcp-app-search-dark.png" light="/screenshots/mcp-app/mcp-app-search-light.png">



</theme-image>

## Edit and review in place

Choose **Edit** from the note reader to open the rich editor. It includes headings, lists, task lists, links, tables, undo and redo, and a preview mode. Changes autosave after a short pause, the status changes to **Saved**, and the app checks for a newer remote revision before overwriting.

The same editor supports shared review markup. You can add attributed comments, suggest insertions, deletions, or replacements, and open any unresolved thread. Suggestions remain inline with the note until someone **Accepts** or **Rejects** them; comments can be resolved or deleted without changing the note text.

Notes and search results show pending comment and suggestion counts, so review work is visible before you open the editor. Excerpts remain clean prose and never expose the underlying CriticMarkup storage.

<theme-image alt="A replacement suggestion with Accept and Reject actions in the MCP App editor" dark="/screenshots/mcp-app/mcp-app-review-dark.png" light="/screenshots/mcp-app/mcp-app-review-light.png">



</theme-image>

For the full review workflow, see [Comments and Suggestions](https://docs.basicmemory.com/cloud/comments-and-suggestions).

## Explore the knowledge graph

Open **Graph** for an overview of the current project's notes and relations. Switch to the full graph to explore the complete connected view, select nodes to inspect their details, and follow a note back into the reader. Graph controls let you zoom, fit the graph to the viewport, and toggle labels; **Overview** returns to the summary.

<theme-image alt="The full Basic Memory knowledge graph inside the MCP App" dark="/screenshots/mcp-app/mcp-app-graph-dark.png" light="/screenshots/mcp-app/mcp-app-graph-light.png">



</theme-image>

## Choose the app or a data tool

The interactive app is for something you want to **see or operate**. Normal MCP data tools are for information the assistant needs to **reason with**.

<table>
<thead>
  <tr>
    <th>
      Goal
    </th>
    
    <th>
      Tool
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Show an interactive note, folder, search, or graph
    </td>
    
    <td>
      <code>
        open_basic_memory
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Read note content for an answer or summary
    </td>
    
    <td>
      <code>
        read_note
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Search for information the assistant will use
    </td>
    
    <td>
      <code>
        search_notes
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Get a directory listing as data
    </td>
    
    <td>
      <code>
        list_directory
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Add, reply to, resolve, accept, or reject review work
    </td>
    
    <td>
      <code>
        review_note
      </code>
    </td>
  </tr>
</tbody>
</table>

For example, “What did we decide about authentication?” should use search and read tools. “Open my authentication notes so I can browse them” should use the interactive app.

## Next steps

<card-group>
<card icon="i-lucide-message-square" title="ChatGPT" to="https://docs.basicmemory.com/integrations/chatgpt">

Connect the published Basic Memory Cloud plugin or a custom MCP server.

</card>

<card icon="i-lucide-message-square-text" title="Comments and Suggestions" to="https://docs.basicmemory.com/cloud/comments-and-suggestions">

Review passages and accept proposed changes individually.

</card>

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

See the parameters for the interactive app and data tools.

</card>
</card-group>


## Sitemap

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