What can you do with this server?

The MCP server for LogSeq enables Claude to programmatically interact with LogSeq graphs via its API, providing comprehensive knowledge management and automation capabilities. **Core Functions:** * **Create Pages**: Generate new pages by specifying title and content * **List Pages**: Retrieve all pages in your graph, with optional inclusion of journal/daily notes * **Read Page Content**: Access and read content from specific pages * **Update Pages**: Modify existing page content * **Delete Pages**: Remove unwanted pages from your graph * **Search Content**: Find specific content across your entire LogSeq graph **AI-Powered Workflows**: Automate tasks like summarizing notes, organizing content, and generating new pages based on existing data for enhanced knowledge management.

Which integrations are available for this server?

Allows interaction with [LogSeq](/mcp/servers/integrations/logseq) via its API, including listing graphs and pages, getting, creating, updating, and deleting pages, and searching content across all pages

MCP server for LogSeq by ergut

✨ 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

Related MCP server: SQLite MCP Server

🚀 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.

MCP server for LogSeq