Integrating my note app with Claude's MCP

Hi, it's Takuya here. I've been fiddling with Claude, which provides an interesting protocol for third-party AI integrations called MCP (Model Context Protocol). Some of my note app (called Inkdrop) users requested that they want to let Claude use their tech notes as knowledge via MCP. Yeah, that sounds very interesting, so I tried to support it.

How to implement an MCP server

MCP itself is a pretty simple protocol and there is already a TypeScript SDK, so you can quickly start implementing it:

GitHub - modelcontextprotocol/typescript-sdk: The official Typescript SDK for Model Context Protocol servers and clients

The official Typescript SDK for Model Context Protocol servers and clients - modelcontextprotocol/typescript-sdk

GitHubmodelcontextprotocol

The Claude desktop app invokes MCP servers locally to interact with external data or services. MCP can accept data via stdio or SSE (HTTP).

Inkdrop supports running an HTTP server locally so you can programmatically access your notes. It allows you to access via MCP as well. For example, to let MCP clients to read a note in the Inkdrop database:

server.tool(
  'read-note',
  'Retrieve the complete contents of the note by its ID from the database.',
  {
    noteId: z
      .string()
      .describe(
        'ID of the note to retrieve. It can be found as `_id` in the note docs'
      )
  },
  async ({ noteId }) => {
    const note: Note[] = await fetchJSON(`/${noteId}`, {})
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(note, null, 2)
        }
      ]
    }
  }
)

Pretty simple!

How to use the Inkdrop MCP server

I've published a repository and npm package for Inkdrop:

GitHub - inkdropapp/mcp-server: Inkdrop Model Context Protocol Server

Inkdrop Model Context Protocol Server. Contribute to inkdropapp/mcp-server development by creating an account on GitHub.

GitHubinkdropapp

1. Set up a local HTTP server
2. Add server config to Claude Desktop:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Example usage

• Can you find my reading notes about a book called "Four Thousand Weeks" in Inkdrop? Then, can you create a new note to summarize these notes in the notebook "Blog"?

Let me know what you will do with this integration!

That's it! I hope you enjoy it 😄

Inkdrop - Note-taking App with Robust Markdown Editor

The Note-Taking App with Robust Markdown Editor

Inkdrop logo