Inkdrop MCP Server logo

Inkdrop MCP Server

by MCP-Mirror

The Inkdrop MCP Server is a Model Context Protocol server designed for the Inkdrop Local HTTP Server API. It allows you to interact with your Inkdrop notes and notebooks programmatically.

View on GitHub

Last updated: N/A

What is Inkdrop MCP Server?

This server is a Model Context Protocol (MCP) server that provides an interface to interact with the Inkdrop note-taking application's local HTTP server API. It allows external applications and services to access and manipulate Inkdrop data.

How to use Inkdrop MCP Server?

To use the server, you need to set up the Inkdrop local HTTP server and configure the server within Claude Desktop by adding the provided JSON configuration to the claude_desktop_config.json file. Ensure the environment variables INKDROP_LOCAL_SERVER_URL, INKDROP_LOCAL_USERNAME, and INKDROP_LOCAL_PASSWORD are correctly set.

Key features of Inkdrop MCP Server

  • Retrieve note content by ID

  • Search notes using keywords and advanced qualifiers

  • List notes within a specified notebook

  • Create new notes

  • Update existing notes

  • List all notebooks and tags

Use cases of Inkdrop MCP Server

  • Integrating Inkdrop with other applications

  • Automating note creation and management

  • Building custom search and filtering tools

  • Creating backups and exporting data

  • Programmatically accessing and manipulating notes

FAQ from Inkdrop MCP Server

How do I find the note ID?

The note ID can be found as _id in the note document. It always starts with note:.

How do I search for notes with specific tags?

Use the search-notes tool with the tag: qualifier, e.g., tag:mytag.

How do I get the full content of a note when list-notes only returns a truncated body?

Use the read-note tool with the note's ID to retrieve the complete content.

What is the _rev field required for updating notes?

The _rev field is the revision ID, a CouchDB MVCC-token that ensures you are updating the latest version of the note. You can obtain it when reading the note.

How can I debug the MCP server?

The best way to debug is to use the MCP Inspector. You can launch it using npx @modelcontextprotocol/inspector "./dist/index.js" after ensuring environment variables are properly configured.