> ## Documentation Index
> Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin

> The Memories plugin for Claude Code and Codex — skills, commands, and the hosted MCP server.

The **Memories plugin** brings the **Video Datalake** into **Claude Code** and **Codex** — search your library, read transcripts and captions, index new videos, and pull any moment, all in natural language.

<Card title="Memories-ai-labs/memories-ai-plugin" icon="github" href="https://github.com/Memories-ai-labs/memories-ai-plugin">
  Source and marketplace on GitHub.
</Card>

The plugin is **thin**: skill docs + commands + a config that points at our hosted [MCP Server](/mcp-server) (`https://mcp.memories.ai/mcp`). **There's no local server to run** — everything (MCP + OAuth) is hosted.

## Install

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude plugin marketplace add Memories-ai-labs/memories-ai-plugin
    claude plugin install memories@memories-ai
    ```

    Or use the `/plugin` menu.
  </Tab>

  <Tab title="Codex">
    ```bash theme={null}
    codex plugin marketplace add Memories-ai-labs/memories-ai-plugin
    codex plugin add memories@memories-ai
    ```

    Or install from the **Plugins** screen in the Codex app.
  </Tab>
</Tabs>

On first use, a browser opens to **sign in to your memories.ai account** and authorize the connection — nothing to run locally.

## Commands

Then just ask, or use the commands:

| Command                      | Does                                              |
| ---------------------------- | ------------------------------------------------- |
| `/memories:search <query>`   | Semantic clip / moment search across your library |
| `/memories:add <url>`        | Index a video URL into your library               |
| `/memories:analyze <ref>`    | Vision-language Q\&A over a video / moment        |
| `/memories:transcribe <ref>` | Read a moment's transcription                     |

## How it works

The plugin bundles **skills + commands + MCP**:

* **Host** (Claude Code / Codex) is the OAuth client — opens the browser, stores the token, sends it per request.
* The **hosted MCP** issues the token (your memories.ai key sealed inside, encrypted) and serves the tools. It never persists your key.
* **memories.ai** is where you sign in; your API key lives there.

## Requirements

A [memories.ai](https://memories.ai) account (free tier works). The MCP server and OAuth are hosted — there's nothing else to install.