Inkdropapp Mcp Server

Name: Inkdropapp Mcp Server
Author: andyciggy

@andyciggy

Repository

About Inkdropapp Mcp Server

No overview available yet

#inkdrop #mcp-server #note-taking

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

The ID of the note to retrieve. It can be found as `_id` in the note docs. It always starts with `note:`.

Keyword to search for.

Results include truncated note bodies (200 characters). Use `read-note` to get full content.

Overview

What is Inkdropapp Mcp Server?

A Model Context Protocol (MCP) server that integrates with the Inkdrop Local HTTP Server API, enabling AI assistants to read, search, list, create, and update notes, as well as list notebooks and tags from an Inkdrop note‑taking database. Designed for users of the Inkdrop app who want to leverage AI tools on their local notes.

How to use Inkdropapp Mcp Server?

Set up a local HTTP server in Inkdrop, then add the server configuration to Claude Desktop’s config file (claude_desktop_config.json). Provide environment variables INKDROP_LOCAL_SERVER_URL, INKDROP_LOCAL_USERNAME, and INKDROP_LOCAL_PASSWORD. The server is launched via npx -y @inkdropapp/mcp-server.

Key features of Inkdropapp Mcp Server

Retrieve full note content by ID (read-note)
Search notes by keyword with advanced qualifiers (search-notes)
List notebooks and tags with built‑in tools
Create new notes with markdown body and optional status
Update existing notes with CouchDB MVCC revision tokens
Results in search-notes and list-notes include truncated bodies (200 chars)

Use cases of Inkdropapp Mcp Server

Fetch a specific note to reference in an AI conversation
Search all notes containing a particular keyword across notebooks
Programmatically create a new note from a chat or automation
List all notebooks or tags for navigation and organization
Update note status (e.g., mark as completed) via an AI assistant

FAQ from Inkdropapp Mcp Server

What does this server do that the Inkdrop API alone does not?

It wraps the Inkdrop Local HTTP Server API as MCP tools, allowing Claude Desktop and other MCP clients to interact with your notes directly without manual API calls.

What are the runtime requirements?

Node.js is required to run the server via npx. Inkdrop must be running with the local HTTP server enabled.

Where are the notes stored? Does the server send data to the cloud?

Notes are stored locally in Inkdrop’s database on your computer. The MCP server communicates only with your local Inkdrop HTTP server; no data is sent externally.