Beeper

This MCP server allows you to interact with a simple note storage system via a lightweight command-line protocol. You can add notes and request summaries of all stored notes, enabling practical workflows that combine local data with concise, generated overviews.

How to use

You interact with the server through an MCP client. Use the add-note tool to store new notes by providing a name and content. Then request a summarize-notes prompt to generate a summary that combines all current notes, with an optional style to control detail level. The server notifies your clients of resource changes so you stay synchronized.

How to install

Prerequisites you need before running the server are a runtime that supports MCP stdio servers and access to the MCP tooling it relies on (the exact runtime name is provided in your environment). Follow the concrete configuration examples below to run the server in stdio mode.

Configure and start a local MCP server using the following explicit configurations for development and publishing. You can run either configuration depending on your environment.

"mcpServers": {
  "beeper_mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/pan/work/openos/beeper/beeper_mcp",
      "run",
      "beeper_mcp"
    ]
  }
}

"mcpServers": {
  "beeper_mcp": {
    "command": "uvx",
    "args": [
      "beeper_mcp"
    ]
  }
}

Additional notes

The server exposes two capabilities: a resource for notes and a prompt to summarize notes. The add-note tool accepts a name and content to create a new note and automatically updates clients about resource changes. The summarize-notes prompt aggregates the current notes and produces a summary in a chosen level of detail.

Troubleshooting and debugging

If you need deeper visibility into MCP interactions, use the MCP Inspector during development. It helps you observe the startup sequence, data flow, and the timing of resource updates.

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.

summarize-notes

Creates summaries of all stored notes with an optional style to control detail level; generates a prompt by combining current notes with the chosen style.