Sherlock

Sherlock MCP Server lets you store and manage notes tied to domains, with a simple note:// URI scheme for accessing individual notes and a prompt you can run to summarize all notes. It exposes practical tools to add notes and generate concise or detailed summaries, enabling you to organize domain-management thoughts and actions in a lightweight, MCP-driven workflow.

How to use

You use Sherlock MCP Server with an MCP client to interact with stored notes and run the available tools. You can add new notes, access existing notes by name, and generate summaries of all notes using the built-in summarize-notes prompt. Your client can request the latest state whenever resources change, so you stay synchronized with the server.

Key capabilities you can leverage:

• Add a new note with a name and content using the add-note tool.
• Access individual notes via the custom note:// URI scheme
• Generate a summarized view of all notes with summarize-notes, optionally adjusting the level of detail using the style argument (brief or detailed).

How to install

Prerequisites you need before installation:

Node.js and npm are commonly used to run MCP tooling and debugging helpers. Ensure Node.js is installed and available in your PATH.

You will run the MCP server using the provided commands for development or published configurations.

"mcpServers": {
  "sherlock-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/pengren/go/github.com/Fewsats/sherlock-mcp",
      "run",
      "sherlock-mcp"
    ]
  }
}

"mcpServers": {
  "sherlock-mcp": {
    "command": "uvx",
    "args": [
      "sherlock-mcp"
    ]
  }
}

Additional notes

Configuration details are indicated for development and published server runs. The development setup uses uv to run from a local directory, while the published setup uses uvx to run a pre-built server image.

Debugging is supported through the MCP Inspector, which you can launch to connect to the running MCP server and observe resource changes and interactions.

npx @modelcontextprotocol/inspector uv --directory /Users/pengren/go/github.com/Fewsats/sherlock-mcp run sherlock-mcp

Configuration and notes

Configuration details for your MCP server are presented in practical blocks above. When you run the development setup, you start the server with the fully specified directory path and command to execute. For a published setup, you start the server with the simplified uvx invocation.

Available tools

add-note

Adds a new note to the server by providing a name and content; updates server state and notifies clients of resource changes.