Logseq
Your graph, searched, read and written by your AI
Salih Ergüt (mcp-logseq) · MIT · free
Your AI searches your Logseq graph, reads pages and blocks, follows backlinks, runs queries, and - when you allow it - creates and edits pages and blocks. It works with both kinds of graph, files and the newer database, through Logseq's own HTTP API on this computer. For a graph kept as files, one switch also keeps the folder among the documents of each AI that uses the tool.
"Add to Your Own AI" opens the app with this ready to add (the app must be installed). Or in the app: Add-ons › Tools › Logseq › Add. Then give it to an AI under Tools.
This tool comes with the app - nothing to fetch from the directory. The server it runs on is fetched the first time an AI uses it.
What it needs
The app checks these for you and installs what it can with one click; the links are the manual route.
- uv (runs the Python tool) - install
- Logseq has to be open with its HTTP API server started (Settings, Features, HTTP APIs server; then the API button in Logseq's toolbar, create a token, Start server) - the Set up list checks for it and says how. Starts read only: your AI can look but not change anything until you switch that off in the tool's settings. The first session fetches the tool itself (mcp-logseq 1.9.1 and the Python packages it runs on, about 45 MB) from the Python package index, so that first start takes longer. Pages you clip from the web can carry instructions meant for an AI: keep Approvals on when you allow writing.
Settings you will be asked for
The app asks for these when you add the tool. They stay on your computer - secrets encrypted - and go only to this tool.
- Logseq API token - kept encrypted - Logseq toolbar: API, Authorization tokens - create one and paste it
- Read only - your AI can look, but not change or delete pages (on to begin with) - a switch
- This is a database graph (Logseq's newer kind, with no Markdown files) - a switch
- Logseq graph folder - for a graph kept as files only (optional) - the folder you opened as a graph in Logseq
- Also remember this graph - read that folder into the documents of each AI that uses this tool, and keep it in sync (on to begin with; files graphs only) - a switch
How it runs
- Started by the app as
- uv tool run --from mcp-logseq==1.9.1 mcp-logseq --read-only
- Source
- github.com/ergut/mcp-logseq (mcp-logseq 1.9.1)
- Where it works
- In chat, whenever a message calls for it, and in projects. Every action goes through your approve step.
- In the app
- since 2026-09-24, built into Your Own AI