Inkdrop

v1.0.0Knowledge & Memorystable

Integrates Inkdrop note-taking app with Claude AI through Model Context Protocol, allowing Claude to search, read, create, and update notes in your Inkdrop database.

inkdrop-mcp-servermcpai-integration
Share:
54
Stars
0
Downloads
0
Weekly
0/5

What is Inkdrop?

Inkdrop is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to integrates inkdrop note-taking app with claude ai through model context protocol, allowing claude to search, read, create, and update notes in your inkdrop database.

Integrates Inkdrop note-taking app with Claude AI through Model Context Protocol, allowing Claude to search, read, create, and update notes in your Inkdrop database.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Integrates Inkdrop note-taking app with Claude AI through Mo

Use Cases

Search, read, create, and update notes in your Inkdrop database directly from Claude.
inkdropapp

Maintainer

LicenseApache 2.0
Languagejavascript
Versionv1.0.0
UpdatedMay 14, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx inkdrop-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Inkdrop

The Inkdrop MCP Server connects Claude and other AI assistants to Inkdrop, the Markdown note-taking app built for developers, via Inkdrop's local HTTP server. It provides 12 tools for searching, reading, creating, updating, and patching notes, as well as managing notebooks and tags — giving Claude full read/write access to your personal knowledge base. Developers use it to query their own notes for context, create new notes from conversations, or reorganize their knowledge base through natural language.

Prerequisites

  • Inkdrop desktop app installed and running (it hosts the local HTTP server that the MCP server connects to)
  • Inkdrop local server enabled in Inkdrop Preferences > Plugins > local-http-server (install the plugin if not present)
  • Node.js 18+ for running the MCP server via npx
  • Your Inkdrop local server credentials (username, password, and port — default port is 19840)
  • Claude Desktop or another MCP-compatible AI client
1

Enable the Inkdrop local HTTP server

In Inkdrop, open Preferences > Plugins and install the 'local-http-server' plugin if not already installed. Enable it and note your configured username, password, and port (default 19840). The MCP server communicates with Inkdrop through this local API.

2

Verify the local server is accessible

Test that Inkdrop's local HTTP server is running by making a quick curl request. You should receive a JSON response with your database info.

curl -u your_username:your_password http://localhost:19840/
3

Configure Claude Desktop with Inkdrop MCP Server

Add the Inkdrop MCP Server to your Claude Desktop config. The server requires three environment variables: the local server URL, username, and password.

{
  "mcpServers": {
    "inkdrop": {
      "command": "npx",
      "args": ["@inkdropapp/mcp-server"],
      "env": {
        "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840",
        "INKDROP_LOCAL_USERNAME": "your_username",
        "INKDROP_LOCAL_PASSWORD": "your_password"
      }
    }
  }
}
4

Restart Claude Desktop

Fully quit and reopen Claude Desktop. The Inkdrop tools should now appear in the tools panel. The server connects to your running Inkdrop app on startup.

5

Test with a search query

Ask Claude to search your notes to confirm the connection. The search supports advanced qualifiers like book:notebook-name, tag:tagname, and status:active.

Inkdrop Examples

Client configuration

Claude Desktop configuration for Inkdrop MCP Server using npx with local server credentials.

{
  "mcpServers": {
    "inkdrop": {
      "command": "npx",
      "args": ["@inkdropapp/mcp-server"],
      "env": {
        "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840",
        "INKDROP_LOCAL_USERNAME": "your_local_username",
        "INKDROP_LOCAL_PASSWORD": "your_local_password"
      }
    }
  }
}

Prompts to try

Example prompts for searching and managing Inkdrop notes through Claude.

- "Search my Inkdrop notes for anything about Docker setup"
- "List all notes in my 'Work' notebook"
- "Create a new note in the 'Projects' notebook titled 'API Design Notes'"
- "Find notes tagged 'todo' and summarize the action items"
- "Read the full content of my note about Kubernetes configuration"
- "Update my note on 'Interview Prep' to add a section about system design"

Troubleshooting Inkdrop

Connection refused error when the MCP server starts

The Inkdrop local HTTP server is not running. Open the Inkdrop desktop app (it must be running in the background), then check that the local-http-server plugin is installed and enabled in Preferences > Plugins. Verify the port matches INKDROP_LOCAL_SERVER_URL.

401 Unauthorized when connecting to the local server

Check the INKDROP_LOCAL_USERNAME and INKDROP_LOCAL_PASSWORD values. These are credentials you configured in the local-http-server plugin settings, not your esa.io/Inkdrop account login credentials. Go to Inkdrop Preferences > Plugins > local-http-server to verify or reset them.

Search returns truncated note content

This is by design — the search-notes tool returns only 200 characters of body text to save tokens. Use the read-note tool with the specific note ID returned in the search results to retrieve the full content. Ask Claude to follow up with read-note on the note IDs of interest.

Frequently Asked Questions about Inkdrop

What is Inkdrop?

Inkdrop is a Model Context Protocol (MCP) server that integrates inkdrop note-taking app with claude ai through model context protocol, allowing claude to search, read, create, and update notes in your inkdrop database. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Inkdrop?

Follow the installation instructions on the Inkdrop GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Inkdrop?

Inkdrop works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Inkdrop free to use?

Yes, Inkdrop is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "inkdrop-mcp-server": { "command": "npx", "args": ["-y", "inkdrop-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Inkdrop?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides