Inkdropapp Mcp Server

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.

Are there any limits on note bodies in search results?

Yes, search-notes and list-notes return only the first 200 characters of each note’s body. Use read-note to obtain the full content.

What transport and authentication does the server use?

The server communicates over stdio (subprocess) and requires a username and password for the local HTTP server, supplied as environment variables.