Skip to main content

Connecting

mnemos connects as a remote MCP server at a single address:

https://mnemos.example.com/mcp

Replace mnemos.example.com with your own installation — whoever deployed it will tell you the address. The client then opens the sign-in page, registers itself with the server and renews access on its own: no client id and no secret to type in.

Claude​

Web and app. Settings → Connectors → Add custom connector. Paste the address, save, press Connect. A sign-in window opens; after it the connector goes active.

Claude Code.

claude mcp add --transport http mnemos https://mnemos.example.com/mcp

The browser opens on the first call. Check with claude mcp list.

ChatGPT​

Needs a paid plan (Plus, Pro, Business, Enterprise, Edu) and the web client — developer mode is not in the mobile apps.

  1. Settings → turn on Developer mode
  2. In app settings, Create app and paste the server address
  3. In a conversation: the plus menu → Developer mode → tick mnemos

OpenAI moves the exact menu path from time to time; the current one is in their documentation.

Grok​

grok.com/connectors → New Connector → Custom, paste the address and sign in. Works on web, iOS and Android.

On Business and Enterprise a team admin has to provision the connector first — xAI's documentation.

Cursor, Zed, Windsurf, VS Code​

All take the same thing: type HTTP (StreamableHTTP), same address. In an MCP settings file that looks like:

{
  "mcpServers": {
    "mnemos": {
      "type": "http",
      "url": "https://mnemos.example.com/mcp"
    }
  }
}

The client signs in by itself on the first call.

If a client asks for a Client ID​

It should not: the server publishes RFC 9728 metadata and the issuer supports dynamic registration and PKCE, so a client registers itself. If the field is demanded anyway, that client cannot do such registration, and the id has to be issued by whoever deployed the installation.

Signing in​

mnemos has no password of its own. You sign in with the account you were given, and the client keeps and renews access.

If sign-in works but the server refuses with a licence message, the account is fine and simply has no entitlement to mnemos — that is settled by whoever issued the account.

Checking it works​

Tell the assistant:

— Check that memory is connected: remember that this is a test note, then find it.

It will call the write and the search and show you the result. If the tools are missing it will say so — then check that the connector is enabled in your client.

Locally​

The same binary speaks stdio — no address, no sign-in, its own database. That is a convenient way to keep personal memory on a laptop; the setup is in the server's README.