Connect your notes to your AI apps over MCP
Locul runs a small MCP server on your computer, so Claude, Codex, Cursor, OpenClaw and Grok Bot can search your notes and recall what Locul has learned from them. These guides show how to connect it, one app or note tool at a time.
Mac and Windows · Claude Code, Claude Desktop, ChatGPT / Codex, Cursor, OpenClaw, Grok Bot
Guides
-
Setup guide
Claude Code MCP server
How to add any MCP server to Claude Code with claude mcp add, which scope to pick and how to check it connected. Then how to add Locul, so Claude Code remembers your notes between sessions.
One click from Locul. It adds itself at user scope, so every project on your computer can use it.
Open the guide -
Cloud connector
Locul cloud connector
A hosted MCP server at team-api.locul.ai/mcp. Add one URL to Claude, ChatGPT, Cursor or VS Code, sign in with your Locul account, and recall your cloud memories from anywhere.
No desktop app needed in that session. Works in claude.ai and chatgpt.com in the browser.
Open the docs -
Setup guide
Obsidian MCP
Connect every Obsidian vault in your home folder to Claude, Codex and Cursor, PDFs included. It also compares the free Obsidian MCP servers and says which one to pick for which job.
No Obsidian plugin. Locul reads the markdown files straight from disk, so Obsidian can stay closed.
Open the guide -
Explainer
Claude memory MCP
What a memory MCP server does for Claude, how it differs from Claude's built-in memory, and how persistent context tools connect to it.
Background reading. Worth a look before you choose which memory tool to connect.
Read the article
What the Locul MCP server is
It's a local program named locul that your AI app starts on your own computer. Through it, the app can search your notes, open one, find related notes, recall the memories Locul has built from your notes, and save a new note. It can't edit or delete the notes you already have.
Claude Code, Claude Desktop and ChatGPT / Codex connect from a button in Locul's AI apps screen. Cursor takes one pasted block, and OpenClaw connects too. In Locul's AI access settings you choose which tools your apps may use, which words they must never see, and which folders they can never read.
By default, Locul's AI builds memories from your notes on our servers and backs them up to your Locul account. Local-only mode keeps that work on your computer. The tools need an active plan or trial, so start your trial first. Guides for more apps and note tools will be added here.
Want your memories in claude.ai or chatgpt.com in the browser, or on a computer without Locul installed? Use the Locul cloud connector, a hosted MCP server you add by URL and sign in to with your Locul account.
Connect Locul to Grok Bot
Grok Bot adds Locul as a connector straight from the chat, so there is no config file or terminal involved. It uses the Locul cloud connector.
- Open Grok Bot and start a chat with your Bot.
- Send it this message:
Add a custom MCP server called Locul at https://team-api.locul.ai/mcp - Grok Bot adds Locul as a connector and shows an Authorize card. Click Authorize.
- Sign in to Locul and approve access.
- That's it. The Locul tools work right away. Try: "What do I already know about Acme Corp?"
You can also add it from grok.com/connectors: New Connector, then Custom, then paste https://team-api.locul.ai/mcp.
Does Locul work with Grok Bot?
Yes. Tell Grok Bot "Add a custom MCP server called Locul at https://team-api.locul.ai/mcp", click the Authorize card it shows, and sign in. The Locul tools are available in that chat right away.
Connect Locul to Cursor
In Locul's AI apps screen, Cursor has a Connect button that writes the entry for you. If you would rather do it by hand, or Cursor is not detected, use Manual setup in the same screen, copy the block for Cursor and add it to Cursor's user-level config file.
Where does Cursor's mcp.json go for Locul?
Cursor reads one user-level file for every project: ~/.cursor/mcp.json on Mac and Linux, %USERPROFILE%\.cursor\mcp.json on Windows. A .cursor/mcp.json inside a project folder only applies to that project. Add a locul entry under mcpServers, restart Cursor, then press Recheck in Locul's AI apps screen.
Is the Locul MCP server a URL?
Not for the desktop app. Locul's MCP server is a local program that Cursor, Claude and Codex start on your own computer, so the entry in mcp.json is a command with arguments, not a web address. An Ollama address such as localhost:11434 is for choosing the AI model in Locul and never belongs in an MCP config. Only the hosted cloud connector uses a URL, https://team-api.locul.ai/mcp.