MCP Notes

MCP Notes Serveris a simple note-taking application built on top of the MCP protocol. Its purpose is to enable users to record and view complex notes and tasks while utilizing AI models, such as recording personal thoughts, notes, inspirations, and insights. It does not rely on creating project files, allowing users to record any content without making it public within the project.

This project includes two servers: a Node.js server using the Model Context Protocol (MCP) for AI-driven note management and a web server providing a user-friendly interface for manual interaction with your notes.

Note:This project requires DynamoDB for note storage. You'll need an AWS account to use it. AWS offers a generous free tier for DynamoDB, making it suitable for frequent personal use at no cost.

- 🖥️Dual Server Architecture:MCP server for AI-driven note management and Web server for the user interface
- 🤖AI-Powered Note Taking:Record thoughts, insights, and tasks through AI interactions
- 🗂️Comprehensive Note Management:Create, list, retrieve, update, and delete notes via AI or web interface
- 📋Reliable Storage:Secure and efficient note storage with AWS DynamoDB
- 🔐Flexible Authentication:Support for AWS credentials via connection strings or environment variables
- 📝Project-Independent:Store personal notes without affecting project files or structure

You can use any model that supports function calls as long as your client supports MCP. The following models have been tested and confirmed to work:

- Claude 3.5 Series
- Gemini 1.5 and 2.0 Series
- GPT-4 Series
- Mistral Large
- Grok-2
- DeepSeek Chat

Run directly withnpxorbunx, see examples below.
- EnsureNode.jsis installed on your system.
- Clone this repository and install dependencies with:npm install
- Configure Claude Desktop or any other tools as shown below

dynamodb://<access_key>:<secret_key>@<region>/<table>

Example:dynamodb://AKIAXXXXXXXX:SKXXXXXXXX@us-east-1/mcp-notes
- ExportAWS_ACCESS_KEY_IDandAWS_SECRET_ACCESS_KEY.
- Supply connection information without credentials in the URI:dynamodb://us-east-1/mcp-notes

Add this snippet toclaude_desktop_config.json:

{ "mcpServers": { "mcp-notes": { "command": "npx", "args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

{ "mcpServers": { "mcp-notes": { "command": "node", "args": [ "file://path/to/notes-mcp-server.js", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

Note:Currently, Cody has limited MCP server support.
It only allows one server connection and cannot make tool calls. You'll need to use the web interface to create and manage notes and then reference them in AI chat conversations.

Add this snippet to your VS Code settings:

{ "openctx.providers": { "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": { "nodeCommand": "node", "mcp.provider.uri": "file://path/to/notes-mcp-server.js", "mcp.provider.args": [ "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

alternatively, use withnpx(not guaranteed to work):

{ "openctx.providers": { "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": { "nodeCommand": "node", "mcp.provider.uri": "file:///usr/local/bin/npx", "mcp.provider.args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

Add this snippet tocline_mcp_settings.json:

You will find a "MCP Server" icon next to the "New Task" button, and then there is an "Edit MCP Settings" button to open this file.

{ "mcpServers": { "mcp-notes": { "command": "npx", "args": [ "-y", "-p", "mcp-notes", "mcp-notes-server", "--dynamodb", "dynamodb://access_key:secret_key@region/table" ] } } }

The web server provides a user-friendly interface for managing your notes. You can launch web interfaces to manage your notes, add new notes for AI, or modify parts of AI-generated notes.

npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://access_key:secret_key@region/table"

bun src/notes-web-server.ts --dynamodb "dynamodb://access_key:secret_key@region/table"

Alternatively, compile withnpm run buildand runnode dist/notes-mcp-server.jsornode dist/notes-web-server.js

Then navigate tohttp://localhost:3100in your browser to view notes.

- Input:{ tags?: string[] }
- Output:Array of all notes, optionally filtered by tags.

- Input:{ id: string }
- Output:A single note object matching the given ID, or a "not found" message if no match exists.

- Input:{ id: string, title: string, summary: string, tags: string[], content: string }
- Output:A success confirmation message.

- Input:{ id: string }
- Output:Deletion confirmation message 🚮.

Notes are stored using the following structure:

- id: A unique identifier for the note. It should be descriptive, with a random number suffix, like "meeting-notes-1362".
- title: The title of the note.
- summary: A short summary of the note's content.
- tags: An array of tags associated with the note (e.g., ["meeting", "project-x"]).
- content: The main content of the note.

❓ Resources don't seem to work; help wanted.

Access and manage your Bear Notes from a local SQLite database.

Connects AI assistants to your Roam Research graph for data access and interaction.

Access and manage your Roam Research graph via its API.

Model your DB-Schema or ERD-Model through MCP. Make notes or use the integrated Kanban

Create notes, search, & think with your Fabric AI workspace

Perform queries and entity operations in your Fibery workspace.

MCP server to interact with Routine: calendars, tasks, notes, etc.

From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.

Interact with markdown notes in a personal knowledge vault, such as Obsidian.

Multi-device file sync, dev-doc CRUD, task management, and session handoffs for AI agents - MCP + OpenAPI dual surface.