KURA Notes

You can run a dedicated MCP server that lets Claude Desktop interact with KURA Notes. This server enables semantic search, note creation, retrieval, and management directly from Claude’s interface, with clear error handling and helpful logging for debugging.

How to use

You connect to a local MCP server that runs as a stdio process. The server exposes five tools you can invoke from Claude Desktop to search, create, retrieve, list, and delete notes in KURA.

How to install

Prerequisites: install Node.js version 20.0.0 or newer and have access to the KURA Notes API with an API key.

Install dependencies, build, and prepare the executable for Claude Desktop integration with the following steps.

Configuration

The MCP server is configured to run as a local stdio server. Use this exact MCP configuration in Claude Desktop to point to the local JavaScript runner and pass your API credentials.

{
  "mcpServers": {
    "kura_notes": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/kura-mcp-client/dist/index.js"],
      "env": {
        "API_KEY": "your-kura-api-key-here",
        "KURA_API_URL": "https://kura.tillmaessen.de"
      }
    }
  }
}

Security and environment

Keep your API key secure. Do not expose API_KEY in public repositories or logs. The server reads API_KEY from the environment, so ensure Claude Desktop is configured to pass the variable securely.

Troubleshooting

If the server does not start or Claude Desktop cannot connect, verify the following: ensure Node.js version is >= 20.0.0, the absolute path in the config is correct, the project is built (npm run build), and dist/index.js is executable.

API key errors indicate the API_KEY environment variable is missing or invalid. Confirm the value is set and restart Claude Desktop after any changes.

Network errors may mean the KURA API is unreachable. Check KURA_API_URL, your network connection, and that the API service is running.

Viewing logs

The MCP client logs to standard error. For macOS/Linux, you can filter logs by running Claude in a terminal session and grepping for the MCP label. On Windows, check Claude Desktop’s application data logs.

Development

The project compiles TypeScript to JavaScript and outputs dist/index.js. Use npm install to install dependencies, npm run build to compile, and you can run the server via the generated dist/index.js as part of your local workflow.

Available tools

kura_search

Performs semantic search across KURA Notes using natural language queries. Allows optional limits, content type filtering, and tag filtering.

kura_create

Creates a new text note with content, optional title, annotation, and tags.

kura_get

Retrieves a specific note by its unique ID.

kura_list_recent

Lists the 20 most recent notes with metadata, excluding full content.

kura_delete

Deletes a note by its ID. This action is permanent.