hippocampOSBack home

Read-only MCP connector

Connect your private memory

Use one OAuth-protected MCP endpoint to bring the right context from your personal and authorized organization brains into Claude, ChatGPT, or Claude Code.

Read-only capabilities

What the connector can do

01

Search memory

Search personal and currently shared organization brains by default, or pass a brain ID to search only that authorized brain.

02

Read a result

Retrieve a search result. Organization viewers receive derived knowledge, without raw source bodies or connector credentials.

03

List brains

Show the named brains available to the authenticated user, including authorized organization brains and Master Brain.

04

Invoke a brain

Retrieve context from a named personal or shared brain, or from Master Brain across all currently authorized brains when explicitly chosen.

What it cannot do

The public connector has no write or delete tools. It cannot change hippocampOS data, inspect billing or account settings, retrieve connector credentials, or query Claude chat history and files.

Before connecting

Sign in to hippocampOS and populate at least one brain. Personal accounts must have an active plan; organization accounts do not need a payment step. The connector only returns memories available to the user who completes OAuth authorization.

Authorization and privacy

Access stays user-scoped

OAuth requests brains:read, search:read, and a separate organization_brains:read permission for shared brains. Every request checks the user's current organization access. General search includes shared brains without a personal-brain link; results are searched at request time and are not copied into a personal brain.

Privacy statementSecurity detailsContact support

Test after authorization

  1. 01Invoke my Work brain. What context do you have about the launch plan?
  2. 02Invoke Hippocampos and show me the brains I can choose from.
  3. 03Search my hippocampOS memory for the latest discussion about onboarding.

If authorization becomes stale, remove the connector in Claude and add it again so OAuth discovery creates a fresh connection.

In Claude Code, run /mcp to review status, authenticate, or clear the saved connection.

Claude

Web and desktop
  1. 01Open Customize, then Connectors in Claude.
  2. 02Select the plus button, choose Add custom connector, and enter the URL below.
  3. 03Authorize hippocampOS, enable it in a chat, and say "invoke my work brain".

Your hippocampOS URL

https://api.hippocampos.io/mcp

OAuth keeps access tied to the hippocampOS account that authorizes the connection.

ChatGPT

Web
  1. 01Open connector setup in ChatGPT.
  2. 02Add the hippocampOS URL below and authorize it.
  3. 03Enable it in a conversation and ask. Your brain answers by name.

Your hippocampOS URL

https://api.hippocampos.io/mcp

The same URL works for every named brain.

Claude Code

Terminal

One command. Your projects stop re-explaining themselves.

Claude Code command

claude mcp add --transport http hippocampos https://api.hippocampos.io/mcp

Claude Code completes authorization when the connection opens.

Stuck? Email us. A human replies fast. Early users can book a 15-minute live setup call.

Email support