mcp-server-logseq 0.0.1__tar.gz

mcp_server_logseq-0.0.1/.env.example

@@ -0,0 +1,2 @@
+LOGSEQ_API_TOKEN=your_token_here
+LOGSEQ_API_URL=http://localhost:12315

mcp_server_logseq-0.0.1/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+.ropeproject/
+.env
+src/mcp_server_logseq/__pycache__/

mcp_server_logseq-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_server_logseq-0.0.1/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: mcp-server-logseq
+Version: 0.0.1
+Summary: An MCP server for LogSeq API
+Project-URL: homepage, https://github.com/dailydaniel/logseq-mcp
+Project-URL: repository, https://github.com/dailydaniel/logseq-mcp
+Project-URL: issues, https://github.com/dailydaniel/logseq-mcp/issues
+Author-email: Daniel Zholkovsky <daniel@zholkovsky.com>
+Maintainer-email: Daniel Zholkovsky <daniel@zholkovsky.com>
+License: MIT
+License-File: LICENSE
+Keywords: automation,http,llm,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.10.2
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: requests>=2.32.3
+Description-Content-Type: text/markdown
+
+# Logseq MCP Server
+A Model Context Protocol server that provides direct integration with Logseq's knowledge base. This server enables LLMs to interact with Logseq graphs, create pages, manage blocks, and organize information programmatically.
+
+## Available Tools
+
+### logseq_insert_block - Creates new blocks in Logseq
+**Parameters:**
+- `parent_block` (string, optional): UUID or content of parent block/page
+- `content` (string, required): Block content in Markdown/Org format
+- `is_page_block` (boolean, optional): Create as page-level block (default: false)
+- `before` (boolean, optional): Insert before parent block (default: false)
+- `custom_uuid` (string, optional): Custom UUIDv4 for the block
+
+### logseq_create_page - Creates new pages with properties
+**Parameters:**
+- `page_name` (string, required): Name of the page to create
+- `properties` (object, optional): Page properties as key-value pairs
+- `journal` (boolean, optional): Create as journal page (default: false)
+- `format` (string, optional): Page format - "markdown" or "org" (default: "markdown")
+- `create_first_block` (boolean, optional): Create initial empty block (default: true)
+
+## Prompts
+
+### logseq_insert_block
+Create a new block in Logseq
+**Arguments:**
+- `parent_block`: Parent block reference (page name or UUID)
+- `content`: Block content
+- `is_page_block`: Set true for page-level blocks
+
+### logseq_create_page
+Create a new Logseq page
+**Arguments:**
+- `page_name`: Name of the page
+- `properties`: Page properties as JSON
+- `journal`: Set true for journal pages
+
+## Installation
+
+### Using pip
+todo: add to pypi
+### From source
+```bash
+git clone https://github.com/dailydaniel/logseq-mcp.git
+cd logseq-mcp
+cp .env.example .env
+uv sync
+```
+Run the server:
+```bash
+python -m mcp_server_logseq
+```
+## Configuration
+### API Key
+1. Generate API token in Logseq: API → Authorization tokens
+2. Set environment variable:
+```bash
+export LOGSEQ_API_TOKEN=your_token_here
+```
+Or pass via command line:
+```bash
+python -m mcp_server_logseq --api-key=your_token_here
+```
+### Graph Configuration
+Default URL: http://localhost:12315
+To customize:
+```bash
+python -m mcp_server_logseq --url=http://your-logseq-instance:port
+```
+## Examples
+## Create meeting notes page
+```plaintext
+Create new page "Team Meeting 2024-03-15" with properties:
+- Tags: #meeting #engineering
+- Participants: Alice, Bob, Charlie
+- Status: pending
+```
+### Add task block to existing page
+```plaintext
+Add task to [[Project Roadmap]]:
+- [ ] Finalize API documentation
+- Due: 2024-03-20
+- Priority: high
+```
+### Create journal entry with first block
+```plaintext
+Create journal entry for today with initial content:
+- Morning standup completed
+- Started work on new authentication system
+```
+## Debugging
+```bash
+npx @modelcontextprotocol/inspector uv --directory . run mcp-server-logseq
+```
+## Contributing
+We welcome contributions to enhance Logseq integration:
+- Add new API endpoints (page linking, query support)
+- Improve block manipulation capabilities
+- Add template support
+- Enhance error handling

mcp_server_logseq-0.0.1/README.md

@@ -0,0 +1,100 @@
+# Logseq MCP Server
+A Model Context Protocol server that provides direct integration with Logseq's knowledge base. This server enables LLMs to interact with Logseq graphs, create pages, manage blocks, and organize information programmatically.
+
+## Available Tools
+
+### logseq_insert_block - Creates new blocks in Logseq
+**Parameters:**
+- `parent_block` (string, optional): UUID or content of parent block/page
+- `content` (string, required): Block content in Markdown/Org format
+- `is_page_block` (boolean, optional): Create as page-level block (default: false)
+- `before` (boolean, optional): Insert before parent block (default: false)
+- `custom_uuid` (string, optional): Custom UUIDv4 for the block
+
+### logseq_create_page - Creates new pages with properties
+**Parameters:**
+- `page_name` (string, required): Name of the page to create
+- `properties` (object, optional): Page properties as key-value pairs
+- `journal` (boolean, optional): Create as journal page (default: false)
+- `format` (string, optional): Page format - "markdown" or "org" (default: "markdown")
+- `create_first_block` (boolean, optional): Create initial empty block (default: true)
+
+## Prompts
+
+### logseq_insert_block
+Create a new block in Logseq
+**Arguments:**
+- `parent_block`: Parent block reference (page name or UUID)
+- `content`: Block content
+- `is_page_block`: Set true for page-level blocks
+
+### logseq_create_page
+Create a new Logseq page
+**Arguments:**
+- `page_name`: Name of the page
+- `properties`: Page properties as JSON
+- `journal`: Set true for journal pages
+
+## Installation
+
+### Using pip
+todo: add to pypi
+### From source
+```bash
+git clone https://github.com/dailydaniel/logseq-mcp.git
+cd logseq-mcp
+cp .env.example .env
+uv sync
+```
+Run the server:
+```bash
+python -m mcp_server_logseq
+```
+## Configuration
+### API Key
+1. Generate API token in Logseq: API → Authorization tokens
+2. Set environment variable:
+```bash
+export LOGSEQ_API_TOKEN=your_token_here
+```
+Or pass via command line:
+```bash
+python -m mcp_server_logseq --api-key=your_token_here
+```
+### Graph Configuration
+Default URL: http://localhost:12315
+To customize:
+```bash
+python -m mcp_server_logseq --url=http://your-logseq-instance:port
+```
+## Examples
+## Create meeting notes page
+```plaintext
+Create new page "Team Meeting 2024-03-15" with properties:
+- Tags: #meeting #engineering
+- Participants: Alice, Bob, Charlie
+- Status: pending
+```
+### Add task block to existing page
+```plaintext
+Add task to [[Project Roadmap]]:
+- [ ] Finalize API documentation
+- Due: 2024-03-20
+- Priority: high
+```
+### Create journal entry with first block
+```plaintext
+Create journal entry for today with initial content:
+- Morning standup completed
+- Started work on new authentication system
+```
+## Debugging
+```bash
+npx @modelcontextprotocol/inspector uv --directory . run mcp-server-logseq
+```
+## Contributing
+We welcome contributions to enhance Logseq integration:
+- Add new API endpoints (page linking, query support)
+- Improve block manipulation capabilities
+- Add template support
+- Enhance error handling

mcp_server_logseq-0.0.1/pyproject.toml

@@ -0,0 +1,35 @@
+[project]
+name = "mcp-server-logseq"
+version = "0.0.1"
+description = "An MCP server for LogSeq API"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "Daniel Zholkovsky", email = "daniel@zholkovsky.com" }]
+maintainers = [{ name = "Daniel Zholkovsky", email = "daniel@zholkovsky.com" }]
+keywords = ["http", "mcp", "llm", "automation"]
+license = { text = "MIT" }
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "pydantic>=2.10.2",
+    "python-dotenv>=1.0.1",
+    "requests>=2.32.3",
+]
+
+[project.urls]
+homepage = "https://github.com/dailydaniel/logseq-mcp"
+repository = "https://github.com/dailydaniel/logseq-mcp"
+issues = "https://github.com/dailydaniel/logseq-mcp/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project.scripts]
+mcp-server-logseq = "mcp_server_logseq.__main__:main"

mcp_server_logseq-0.0.1/src/mcp_server_logseq/__init__.py

@@ -0,0 +1,43 @@
+from .server import serve
+
+
+def main():
+    """MCP LogSeq Server - AI-powered note taking for MCP"""
+    import argparse
+    import asyncio
+    import os
+    from dotenv import load_dotenv
+
+    load_dotenv()
+
+    parser = argparse.ArgumentParser(
+        description="Share your LogSeq notes with LLM (https://docs.logseq.com/#/page/local%20http%20server)"
+    )
+    parser.add_argument(
+        "--api-key",
+        type=str,
+        help="LogSeq API key",
+    )
+    parser.add_argument(
+        "--url",
+        type=str,
+        help="LogSeq API host",
+    )
+
+    args = parser.parse_args()
+
+    # Check for API key in args first, then environment
+    api_key = args.api_key or os.getenv("LOGSEQ_API_TOKEN")
+    if not api_key:
+        parser.error("LogSeq API key must be provided either via --api-key or LOGSEQ_API_TOKEN environment variable")
+
+    # Check for URL in args first, then environment
+    url = args.url or os.getenv("LOGSEQ_API_URL")
+    if not url:
+        parser.error("LogSeq API URL must be provided either via --url or LOGSEQ_API_URL environment variable")
+
+    asyncio.run(serve(api_key, url))
+
+
+if __name__ == "__main__":
+    main()

mcp_server_logseq-0.0.1/src/mcp_server_logseq/__main__.py

@@ -0,0 +1,5 @@
+# __main__.py
+
+from mcp_server_logseq import main
+
+main()