Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion content/03.cloud/15.mcp-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,20 @@ Your assistant calls `open_basic_memory` and opens the requested view. The defau
::theme-image{light="/screenshots/mcp-app/mcp-app-open-light.png" dark="/screenshots/mcp-app/mcp-app-open-dark.png" alt="The Basic Memory MCP App open to the Notes gallery inside an AI conversation"}
::

## 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{light="/screenshots/mcp-app/mcp-app-expand-control-light.png" dark="/screenshots/mcp-app/mcp-app-expand-control-dark.png" alt="The Expand action in the Basic Memory MCP App header"}
::

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{light="/screenshots/mcp-app/mcp-app-fullscreen-light.png" dark="/screenshots/mcp-app/mcp-app-fullscreen-dark.png" alt="The Basic Memory MCP App expanded to a full-screen workspace in an AI client"}
::

## 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.
Expand Down Expand Up @@ -69,7 +83,12 @@ From the reader you can:

### Add a note to your prompt

Click the note title in the reader. The **Use note in conversation** action adds a prepared prompt to the conversation composer.
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{light="/screenshots/mcp-app/mcp-app-use-note-gallery-light.png" dark="/screenshots/mcp-app/mcp-app-use-note-gallery-dark.png" alt="The Use note in conversation action on a note card in the Basic Memory MCP App gallery"}
::

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

::theme-image{light="/screenshots/mcp-app/mcp-app-use-note-title-light.png" dark="/screenshots/mcp-app/mcp-app-use-note-title-dark.png" alt="The clickable note title in the full Basic Memory MCP App reader header"}
::
Expand Down
42 changes: 42 additions & 0 deletions docs/screenshots.json
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,34 @@
"captured": "2026-08-20",
"theme": "dark"
},
{
"path": "screenshots/mcp-app/mcp-app-expand-control-light.png",
"page": "/cloud/mcp-app",
"source": "Expand action in the inline Basic Memory MCP App header",
"captured": "2026-08-22",
"theme": "light"
},
{
"path": "screenshots/mcp-app/mcp-app-expand-control-dark.png",
"page": "/cloud/mcp-app",
"source": "Expand action in the inline Basic Memory MCP App header",
"captured": "2026-08-22",
"theme": "dark"
},
{
"path": "screenshots/mcp-app/mcp-app-fullscreen-light.png",
"page": "/cloud/mcp-app",
"source": "Basic Memory MCP App expanded to the full-screen workspace",
"captured": "2026-08-22",
"theme": "light"
},
{
"path": "screenshots/mcp-app/mcp-app-fullscreen-dark.png",
"page": "/cloud/mcp-app",
"source": "Basic Memory MCP App expanded to the full-screen workspace",
"captured": "2026-08-22",
"theme": "dark"
},
{
"path": "screenshots/mcp-app/mcp-app-use-folder-light.png",
"page": "/cloud/mcp-app",
Expand Down Expand Up @@ -92,6 +120,20 @@
"captured": "2026-08-20",
"theme": "dark"
},
{
"path": "screenshots/mcp-app/mcp-app-use-note-gallery-light.png",
"page": "/cloud/mcp-app",
"source": "Use note in conversation action on a Notes gallery card",
"captured": "2026-08-22",
"theme": "light"
},
{
"path": "screenshots/mcp-app/mcp-app-use-note-gallery-dark.png",
"page": "/cloud/mcp-app",
"source": "Use note in conversation action on a Notes gallery card",
"captured": "2026-08-22",
"theme": "dark"
},
{
"path": "screenshots/mcp-app/mcp-app-use-note-title-light.png",
"page": "/cloud/mcp-app",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading