Locul Cloud Memory

npx add-mcp 'https://team-api.locul.ai/mcp'

Your Locul brain in Claude, ChatGPT and Cursor, from anywhere

The Locul cloud connector is a hosted MCP server. Add one URL to your AI app, sign in with your Locul account, and it can recall your memories and save new ones, even in a browser with no desktop app running.

Server URL: https://team-api.locul.ai/mcp · Streamable HTTP · OAuth 2.1

YOUR AI APP Claude ChatGPT Cursor, VS Code MCP over HTTPS ENDPOINT team-api.locul.ai/mcp OAuth sign-in your account only LOCUL CLOUD BRAIN memories, entities, sources YOUR AI APP Claude ChatGPT Cursor, VS Code MCP over HTTPS ENDPOINT team-api.locul.ai/mcp OAuth sign-in your account only LOCUL CLOUD BRAIN memories, entities, sources

01What the cloud connector does

Locul builds a second brain from the notes, documents and dictations you already keep: short memories about the people, companies, projects and decisions in your work. The cloud connector is a hosted MCP server at https://team-api.locul.ai/mcp that lets an AI app reach that brain from anywhere, including claude.ai and chatgpt.com in a browser, with no desktop app running.

Once connected, your AI app can recall what you know about a client before it drafts a proposal, open the note behind a memory to check it, and save something new you ask it to remember. It works with the memories in your Locul cloud brain: the ones the desktop app backs up to your Locul account, plus any you save through a connector.

Local or cloud? If you use Locul on your own computer with Claude Code, Claude Desktop, Codex or Cursor, the desktop MCP server runs on your machine, reads your notes straight from disk and has a wider set of tools. Use this cloud connector when the AI app runs in a browser or on a machine without Locul installed.

02Before you connect

• A Locul account with an active plan or trial. You create the account in the Locul app; signing in with Google during the connect step can also create one.
• Memories in your cloud brain. Install the Locul app, point it at your notes and let it build your memories. With the default settings they are backed up to your Locul account and appear here. Memories made in local-only mode stay on your computer and are not available to the cloud connector.

03Tools

The server exposes nine tools. Eight only read. One, create_memory, writes, and it can only add a new memory: no tool edits or deletes an existing memory. Every tool carries the standard MCP annotations (readOnlyHint, destructiveHint), so apps that ask before a write can do so.

• recall_memories Semantic and keyword recall over your cloud memories, optionally scoped to one person, company, project or topic.Read only
• search_notes Full-text keyword search across the facts in your cloud memories.Read only
• get_entity_profile Everything on one person, company, product, project, tool or topic: its top memories, relationships and aliases.Read only
• get_brain_index A top-down map of your cloud brain: total counts plus the entities that come up most.Read only
• get_memory_source The source behind one memory: the fact plus the title and path of the note it came from.Read only
• memory_stats Counts for your cloud brain: active, superseded and orphaned memories, plus entities and sources.Read only
• create_memory Saves a new memory to your cloud brain right away and links it to the entities it mentions. Duplicates are skipped.Writes
• search Search in the format ChatGPT connectors expect, returning matching memories as result records.Read only
• fetch The full record for one memory returned by search, in the format ChatGPT connectors expect.Read only

04Set up in Claude

claude.ai and Claude Desktop

1. Open Settings, then Connectors, and choose Add custom connector.
2. Name it Locul and paste the server URL below.
3. Click Connect and sign in with your Locul account (see sign-in).
4. In a chat, turn the Locul connector on from the tools menu and ask, for example: "What do I already know about Acme Corp?"

https://team-api.locul.ai/mcp

Claude Code

Add the server, then run /mcp inside Claude Code and pick Locul to sign in. On a computer with Locul installed, the local Claude Code setup reads your notes straight from disk and has more tools.

claude mcp add --transport http locul https://team-api.locul.ai/mcp

05Set up in ChatGPT

In ChatGPT, add a custom connector (custom connectors need developer mode, which you turn on under Settings, Apps and connectors, Advanced). Use the same server URL, choose OAuth, and sign in with your Locul account. ChatGPT uses the search and fetch tools, so your ChatGPT chats recall from the same brain as Claude.

https://team-api.locul.ai/mcp

06Set up in Grok Bot

Grok Bot, xAI's always-on AI teammate, adds Locul as a connector straight from the chat, so there is no config file or terminal involved.

1. Open Grok Bot and start a chat with your Bot.
2. Send it this message: Add a custom MCP server called Locul at https://team-api.locul.ai/mcp
3. Grok Bot adds Locul as a connector and shows an Authorize card. Click Authorize.
4. Sign in with your Locul account (see sign-in). The Locul tools work right away. Try: "What do I already know about Acme Corp?"

On grok.com in a browser, you can add it under Connectors instead: choose New Connector, then Custom, paste the server URL and sign in.

https://team-api.locul.ai/mcp

07Set up in Cursor

Add Locul to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor opens the Locul sign-in page in your browser the first time it connects.

~/.cursor/mcp.json

{
  "mcpServers": {
    "locul": {
      "url": "https://team-api.locul.ai/mcp"
    }
  }
}

08Set up in VS Code

Add Locul to .vscode/mcp.json in your workspace, or run MCP: Add Server from the command palette and choose HTTP. VS Code asks you to sign in when the server first starts.

.vscode/mcp.json

{
  "servers": {
    "locul": {
      "type": "http",
      "url": "https://team-api.locul.ai/mcp"
    }
  }
}

09How sign-in works

The connector uses OAuth 2.1 with PKCE, so your AI app never sees your password. Apps that support MCP sign-in register themselves automatically; there is no client ID or key to copy.

1. Your AI app opens the Locul Connect your brain page in your browser. It names the app asking for access and lists what the connection can do.
2. Sign in with Google, with your email and password, or ask for a one-time sign-in code by email.
3. Locul sends your app back a short-lived access token for your account only. The app refreshes it in the background, so you stay connected without signing in again.

To disconnect, remove the Locul connector in your AI app. If your plan or trial ends, the server stops answering tool calls until it is active again.