📌Overview

Purpose: The MCP server facilitates interaction with LogSeq through its API, enabling various functionalities for managing and accessing notes and pages.

Overview: The MCP server is designed to enhance user interaction with LogSeq by providing a set of tools to manage graphs and pages efficiently. By integrating with the LogSeq API, users can streamline their note-taking and information retrieval activities.

Key Features:

• Graph Management: Tools like list_graphs and list_pages allow users to easily navigate through all available graphs and access specific pages within the current graph.

• Content Manipulation: Functions such as create_page, update_page, and delete_page enable users to manipulate content directly, making it simple to organize and maintain their notes.

• Information Retrieval: With the search and get_page_content functionalities, users can quickly find relevant information across all pages or retrieve specific page contents when needed.

---

MCP server for LogSeq

MCP server to interact with LogSeq via its API.

Components

Tools

The server implements multiple tools to interact with LogSeq:

• list_graphs: Lists all available graphs
• list_pages: Lists all pages in the current graph
• get_page_content: Return the content of a single page
• search: Search for content across all pages
• create_page: Create a new page
• update_page: Update content of an existing page
• delete_page: Delete a page

Example prompts

It's good to first instruct Claude to use LogSeq. Then it will always call the tool.

Example prompts:

• Get the contents of my latest meeting notes and summarize them
• Search for all pages where Project X is mentioned and explain the context
• Create a new page with today's meeting notes
• Update the project status page with the latest updates

Configuration

LogSeq API Configuration

You can configure the environment with LogSeq API settings in two ways:

1. Add to server config (preferred)

{
  "mcp-logseq": {
    "command": "uvx",
    "args": [
      "mcp-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "<your_api_token_here>",
      "LOGSEQ_API_URL": "http://localhost:12315"
    }
  }
}

2. Create a .env file in the working directory with the required variables:

LOGSEQ_API_TOKEN=your_token_here
LOGSEQ_API_URL=http://localhost:12315

Development

Building

To prepare the package for distribution:

uv sync

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-logseq run mcp-logseq