MCP server for LogSeq

✨ What You Can Do

Transform your LogSeq knowledge base into an AI-powered workspace! This MCP server enables Claude to seamlessly interact with your LogSeq graphs.

🎯 Real-World Examples

📊 Intelligent Knowledge Management

"Analyze all my project notes from the past month and create a status summary"
"Find pages mentioning 'machine learning' and create a study roadmap"
"Search for incomplete tasks across all my pages"

📝 Automated Content Creation

"Create a new page called 'Today's Standup' with my meeting notes"
"Add today's progress update to my existing project timeline page"  
"Create a weekly review page from my recent notes"

🔍 Smart Research & Analysis

"Compare my notes on React vs Vue and highlight key differences"
"Find all references to 'customer feedback' and summarize themes"
"Create a knowledge map connecting related topics across pages"

🤝 Meeting & Documentation Workflow

"Read my meeting notes and create individual task pages for each action item"
"Get my journal entries from this week and create a summary page"
"Search for 'Q4 planning' and organize all related content into a new overview page"

💡 Key Benefits

Zero Context Switching: Claude works directly with your LogSeq data
Preserve Your Workflow: No need to export or copy content manually
Intelligent Organization: AI-powered page creation, linking, and search
Enhanced Productivity: Automate repetitive knowledge work

🚀 Quick Start

Step 1: Enable LogSeq API

Settings → Features → Check "Enable HTTP APIs server"
Click the API button (🔌) in LogSeq → "Start server"
Generate API token: API panel → "Authorization tokens" → Create new

Step 2: Add to Claude (No Installation Required!)

Claude Code

claude mcp add mcp-logseq \
  --env LOGSEQ_API_TOKEN=your_token_here \
  --env LOGSEQ_API_URL=http://localhost:12315 \
  -- uv run --with mcp-logseq mcp-logseq

Claude Desktop

Add to your config file (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "mcp-logseq": {
      "command": "uv",
      "args": ["run", "--with", "mcp-logseq", "mcp-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "your_token_here",
        "LOGSEQ_API_URL": "http://localhost:12315"
      }
    }
  }
}

Step 3: Start Using!

"Please help me organize my LogSeq notes. Show me what pages I have."

🛠️ Available Tools

The server provides 6 comprehensive tools:

Tool	Purpose	Example Use
`list_pages`	Browse your graph	"Show me all my pages"
`get_page_content`	Read page content	"Get my project notes"
`create_page`	Add new pages	"Create a meeting notes page"
`update_page`	Modify existing pages	"Update my task list"
`delete_page`	Remove pages	"Delete the old draft page"
`search`	Find content across graph	"Search for 'productivity tips'"

⚙️ Prerequisites

LogSeq Setup

LogSeq installed and running
HTTP APIs server enabled (Settings → Features)
API server started (🔌 button → "Start server")
API token generated (API panel → Authorization tokens)

System Requirements

uv Python package manager
MCP-compatible client (Claude Code, Claude Desktop, etc.)

🔧 Configuration

Environment Variables

LOGSEQ_API_TOKEN (required): Your LogSeq API token
LOGSEQ_API_URL (optional): Server URL (default: http://localhost:12315)

Alternative Setup Methods

Using .env file

# .env
LOGSEQ_API_TOKEN=your_token_here
LOGSEQ_API_URL=http://localhost:12315

System environment variables

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

🔍 Verification & Testing

Test LogSeq Connection

uv run --with mcp-logseq python -c "
from mcp_logseq.logseq import LogSeq
api = LogSeq(api_key='your_token')
print(f'Connected! Found {len(api.list_pages())} pages')
"

Verify MCP Registration

claude mcp list  # Should show mcp-logseq

Debug with MCP Inspector

npx @modelcontextprotocol/inspector uv run --with mcp-logseq mcp-logseq

🐛 Troubleshooting

Common Issues

"LOGSEQ_API_TOKEN environment variable required"

✅ Enable HTTP APIs in Settings → Features
✅ Click 🔌 button → "Start server" in LogSeq
✅ Generate token in API panel → Authorization tokens
✅ Verify token in your configuration

"spawn uv ENOENT" (Claude Desktop)

Claude Desktop can't find uv. Use the full path:

which uv  # Find your uv location

Update config with full path:

{
  "mcpServers": {
    "mcp-logseq": {
      "command": "/Users/username/.local/bin/uv",
      "args": ["run", "--with", "mcp-logseq", "mcp-logseq"],
      "env": { "LOGSEQ_API_TOKEN": "your_token_here" }
    }
  }
}

Common uv locations:

Curl install: ~/.local/bin/uv
Homebrew: /opt/homebrew/bin/uv
Pip install: Check with which uv

Connection Issues

✅ Confirm LogSeq is running
✅ Verify API server is started (not just enabled)
✅ Check port 12315 is accessible
✅ Test with verification command above

👩‍💻 Development

For local development, testing, and contributing, see DEVELOPMENT.md.

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Interacts with LogSeq via its API.

Related MCP Servers

Logseq MCP Server
dailydaniel
A
security
A
license
A
quality
A server that enables LLMs to programmatically interact with Logseq knowledge graphs, allowing creation and management of pages and blocks.
Last updated -
10
24
MIT License
SQLite MCP Server
direkt
-
security
F
license
-
quality
Enables querying log data stored in SQLite databases through the Model Context Protocol, allowing natural language interactions with log analysis.
Last updated -
Logseq MCP Tools
joelhooks
-
security
F
license
-
quality
A Model Context Protocol server that provides AI assistants with structured access to your Logseq knowledge graph, enabling retrieval, searching, analysis, and creation of content within your personal knowledge base.
Last updated -
48
Datadog MCP Server
Nozomuts
A
security
A
license
A
quality
Enables interaction with Datadog's monitoring platform to search logs, search trace spans, and perform trace span aggregation for analysis.
Last updated -
3
MIT License

View all related MCP servers