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

How do I use MCP server for LogSeq?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type `@` followed by the MCP server name and your instructions, e.g., "`@MCP server for LogSeq` create a new page for today's meeting notes and link it to the project overview" That's it! The server will respond to your query, and you can continue using it as needed. Here is a [step-by-step guide with screenshots](https://glama.ai/blog/2025-07-08-how-to-install-and-use-mcp-servers).

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