Logseq MCP Server

Agents need durable memory, and you already maintain one — your graph. The missing piece is access you can trust: an agent should read broadly and

Local serverstdio

What is the Logseq MCP MCP server?

Logseq MCP MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Agents need durable memory, and you already maintain one — your graph. The missing piece is access you can trust: an agent should read broadly and write usefully, but never touch what it shouldn't — and never do anything you can't see.

What you get

  • Namespace-scoped writes. — Agents write only under their own prefix
  • An audit trail in your daily journal. — Every successful write appends a
  • Verified queries as tools. — Ship known-good Datalog from config as named

What the assistant can call

Once Logseq MCP is connected, these are the calls the assistant has available:

  • Authentication — The Streamable HTTP transport requires a bearer token: every request must send Authorization: Bearer <LOGSEQ_MCP_HTTP_TOKEN>, or it gets 401. The
  • Find — The Find tool exposed by this server
  • Guide — The Guide tool exposed by this server
  • Read — The Read tool exposed by this server
  • Tasks — The Tasks tool exposed by this server
  • Dynamic — The Dynamic tool exposed by this server

Setting it up

The server ships on npm as @modelcontextprotocol/inspector, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration and credentials

You will need 5 environment variables: LOGSEQ_API_TOKEN, LOGSEQ_API_URL, YOUR_TOKEN, LOGSEQ_MCP_HTTP_TOKEN, LOGSEQ_MCP_HOST. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • A running Logseq with the local HTTP API server enabled (Settings → Features → HTTP APIs server, then start it from the 🔌 menu). - An authorization token created in the HTTP API server settings.

Choosing this one

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Logseq MCP's toolset — Authentication, Find, Guide and 3 more — is a fair guide to whether it matches your workflow. It is maintained by dailydaniel; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Logseq MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the logseq mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
AuthenticationThe Streamable HTTP transport **requires** a bearer token: every request must send Authorization: Bearer <LOGSEQ_MCP_HTTP_TOKEN>, or it gets 401. The server refuses to start in this mode without a token set. Note this is
FindThe Find tool exposed by this server.
GuideThe Guide tool exposed by this server.
ReadThe Read tool exposed by this server.
TasksThe Tasks tool exposed by this server.
DynamicThe Dynamic tool exposed by this server.

How to install the Logseq MCP MCP server

### Claude Desktop

```json
{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_TOKEN>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • A running Logseq with the local HTTP API server enabled (Settings → Features → HTTP APIs server, then start it from the 🔌 menu). - An authorization token created in the HTTP API server settings.
VariableDescriptionRequired
LOGSEQ_API_TOKENCredential the server authenticates with.Yes
LOGSEQ_API_URLEndpoint or connection string the server talks to.Yes
YOUR_TOKENCredential the server authenticates with.Yes
LOGSEQ_MCP_HTTP_TOKENCredential the server authenticates with.Yes
LOGSEQ_MCP_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • Use Logseq MCP to Authentication.
  • Use Logseq MCP to Find.
  • Use Logseq MCP to Guide.

Frequently asked questions

It connects Logseq MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (Authentication, Find, Guide, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Logseq MCP directly.