LogSeq

by ergut

48 stars

Not rated

GitHub

About

Integrates with LogSeq API to enable automated note-taking, content searching, and knowledge management tasks.

Details

Author: ergut
Repository: ergut/mcp-logseq
GitHub stars: 48
License: MIT License
Categories: Productivity, Developer Tools, Design, AI, Search, Project Management, Infrastructure, Automation
Tags: #mobile

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name LogSeq

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 run
- Argument 2 --with
- Argument 3 mcp-logseq
- Argument 4 mcp-logseq
Environment
- LOGSEQ_API_URL http://localhost:12315
- LOGSEQ_API_TOKEN your_token_here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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"

      }

    }

  }

}

`list_pages`

Browse your graph. Example use: 'Show me all my pages'.

`get_page_content`

Read page content. Example use: 'Get my project notes'.

`create_page`

Add new pages with structured blocks. Example use: 'Create a meeting notes page with agenda items'.

`update_page`

Modify pages (append/replace modes). Example use: 'Update my task list'.

`delete_page`

Remove pages. Example use: 'Delete the old draft page'.

`delete_block`

Remove a block by UUID. Example use: 'Delete this specific block'.

`update_block`

Edit block content by UUID. Example use: 'Update this specific block text'.

`search`

Find content across graph. Example use: 'Search for 'productivity tips'.

`query`

Execute Logseq DSL queries. Example use: 'Find all TODO tasks tagged #project'.

`find_pages_by_property`

Search pages by property. Example use: 'Find all pages with status = active'.

`get_pages_from_namespace`

List pages in a namespace. Example use: 'Show all pages under Customer/'.

`get_pages_tree_from_namespace`

Hierarchical namespace view. Example use: 'Show Projects/ as a tree'.

`rename_page`

Rename with reference updates. Example use: 'Rename 'Old Name' to 'New Name'.

`get_page_backlinks`

Find pages linking to a page. Example use: 'What links to this page?'.

`insert_nested_block`

Insert child/sibling blocks. Example use: 'Add a child block under this task'.

`set_block_properties`

Set DB-mode class properties on a block. Example use: 'Set the status of this block to active' (DB-mode only).

`vector_search`

Semantic search by meaning. Example use: 'Find notes about shadow work or Jung'.

`sync_vector_db`

Sync vector DB with graph files. Example use: 'Update the search index'.

`vector_db_status`

Show vector DB health and staleness. Example use: 'Is my search index up to date?'.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Step 1: Enable LogSeq API

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop

list_pages

get_page_content

create_page

update_page

delete_page

delete_block

update_block

search

query

find_pages_by_property

get_pages_from_namespace

get_pages_tree_from_namespace

rename_page

get_page_backlinks

insert_nested_block

set_block_properties

vector_search

sync_vector_db

vector_db_status

Claude Desktop / Cursor

Linux

Macos

Windows

Step 1: Enable LogSeq API

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`list_pages`

`get_page_content`

`create_page`

`update_page`

`delete_page`

`delete_block`

`update_block`

`search`

`query`

`find_pages_by_property`

`get_pages_from_namespace`

`get_pages_tree_from_namespace`

`rename_page`

`get_page_backlinks`

`insert_nested_block`

`set_block_properties`

`vector_search`

`sync_vector_db`

`vector_db_status`