📌Overview

Purpose: The Inkdrop MCP Server is designed to facilitate local HTTP server interactions using the Model Context Protocol for the Inkdrop application, enhancing the management and retrieval of notes stored in the Inkdrop database.

Overview: The Inkdrop MCP Server provides a powerful interface for accessing and managing notes through a local HTTP server setup, allowing users to perform various operations such as retrieving, searching, creating, and updating notes efficiently.

Key Features:

• Note Retrieval (read-note): Enables retrieval of the contents of specific notes by their ID, enhancing quick access to important information.

• Note Search (search-notes): Offers functionality to search for notes containing specific keywords, including advanced search qualifiers, to streamline the discovery of relevant content.

• Notebook Navigation (list-notes, list-notebooks): Allows users to list notes in a specific notebook or retrieve all notebooks, facilitating better organization and management of notes based on custom categories.

• Note Creation & Update (create-note, update-note): Provides capabilities for users to create new notes or update existing ones, supporting Markdown formatting and status management for effective note-taking.

---

Inkdrop MCP Server

A Model Context Protocol server for the Inkdrop Local HTTP Server API.

Installation

1. Set up a local HTTP server.
2. Add server config to Claude Desktop:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "inkdrop": {
      "command": "npx",
      "args": ["-y", "@inkdropapp/mcp-server"],
      "env": {
        "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840",
        "INKDROP_LOCAL_USERNAME": "your-local-server-username",
        "INKDROP_LOCAL_PASSWORD": "your-local-server-password"
      }
    }
  }
}

Components

Tools

1. read-note: Retrieve the complete contents of a note by its ID.

   • Required Input: noteId (always starts with note:).

2. search-notes: List all notes that contain a given keyword.

   • Required Input: keyword.
   • Note: Supports advanced search qualifiers.

3. list-notes: List all notes in a specified notebook.

   • Required Input: bookId (always starts with 'book:').
   • Optional Inputs: Include tagIds, keyword, sort, and descending.

4. create-note: Create a new note.

   • Required Inputs: bookId, title, body.
   • Optional Input: status.

5. update-note: Update an existing note.

   • Required Inputs: _id, _rev, bookId, title, body.
   • Optional Input: status.

6. list-notebooks: Retrieve a list of all notebooks.

7. list-tags: Retrieve a list of all tags.

Debugging

For the best debugging experience, we recommend using the MCP Inspector. Launch it with the following command:

npx @modelcontextprotocol/inspector "./dist/index.js"

Ensure that environment variables are properly configured. Upon launching, the Inspector will display a URL for debugging.

To watch the server logs, use:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-inkdrop.log