Inkdrop MCP Server logo

Inkdrop MCP Server

by inkdropapp

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?

The Inkdrop MCP Server is a bridge between the Model Context Protocol and the Inkdrop note-taking application's local HTTP server. It exposes Inkdrop's data and functionalities through a standardized protocol, enabling integration with other applications and services.

How to use Inkdrop MCP Server?

To use the server, first set up the Inkdrop local HTTP server. Then, configure your MCP client (like Claude Desktop) to connect to the server by specifying the command and environment variables, including the Inkdrop local server URL, username, and password. You can then use the provided tools to interact with your notes and notebooks.

Key features of Inkdrop MCP Server

  • Retrieve note content by ID

  • Search notes by keyword

  • List notes in a notebook

  • Create new notes

  • Update existing notes

  • List all notebooks

  • List all tags

Use cases of Inkdrop MCP Server

  • Automated note organization and management

  • Integration with personal knowledge management systems

  • Programmatic note creation and modification

  • Building custom Inkdrop extensions and integrations

FAQ from Inkdrop MCP Server

How do I find the note ID?

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

How can I get the full content of a note when search-notes returns a truncated body?

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

What are the valid values for the 'status' field when creating or updating a note?

The valid values are: none, active, onHold, completed, and dropped.

How do 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" and access it in your browser.

Where can I find the server logs?

You can watch the server logs using the command tail -n 20 -f ~/Library/Logs/Claude/mcp-server-inkdrop.log (on macOS).