home / mcp / notes manager mcp server

Notes Manager MCP Server

Provides a notes data model with tools to add, list, search, and delete notes plus resources describing the data.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "brainupgrade-in-mcp-server-typescript-starter": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-server-typescript-starter/dist/index.js"
      ]
    }
  }
}

This MCP server provides a lightweight notes manager that AI clients can interact with to create, list, search, and delete notes. It exposes tools for performing these actions and resources that describe the current notes data. You run the server locally, connect with an MCP client, and test your setup with an inspector tool before integrating it into your workflows.

How to use

You connect an MCP client to the notes manager server to perform operations. Use the available tools to add notes, list existing notes, search by title, content, or tags, and remove notes by their IDs. You can also access a JSON resource that lists all notes and individual notes by ID. Start by launching the server, then configure your client to point to the local MCP endpoint. Try common prompts such as adding a note, listing notes, searching for notes by keywords, or deleting a note by its ID.

To verify the server is responding as expected, you can inspect the available tools and resources using a built-in inspector. This helps you confirm the tool names, input schemas, and the resource URIs before integrating the server into broader workflows.

How to install

Prerequisites you need installed on your machine before running the MCP server:

- Node.js 18 or newer

- npm or yarn

- A testing client or Claude Desktop for experimentation

Step-by-step setup you can follow exactly:

# Clone the repository
git clone https://github.com/brainupgrade-in/mcp-server-typescript-starter.git
cd mcp-server-typescript-starter

# Install dependencies
npm install

# Build the project
npm run build

Configure Claude Desktop and run locally

You connect Claude Desktop to your local MCP server by adding a config entry that points to the server executable. The example uses a local node process to run the compiled server.

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-typescript-starter/dist/index.js"]
    }
  }
}

Start the inspector for testing

After building, you can open the MCP Inspector to test tools and resources. This lets you practice calling tools and inspecting responses in a browser-based interface.

npm run inspector

Ongoing configuration and usage notes

The server is designed to be extended with persistence, prompts, and authentication as you expand its capabilities. You can add persistence by wiring up a file or database for notes, implement prompts for predefined instruction templates, and consider multi-user support for shared notes.

Project structure

The project layout includes the source TypeScript code, a built distribution, and configuration and tooling files that help you run and test the server locally.

Key parts include the main server entry point, compiled JavaScript in dist, and scripts for building and testing.

Available tools

add_note

Create a new note with a title and content, optionally including tags.

list_notes

List all notes with their IDs and titles.

search_notes

Search notes by title, content, or tags.

delete_note

Delete a note by its ID.