MCP Note-Taking System

v1.0.0Knowledge & Memorystable

A personal knowledge management system built on the Model Context Protocol that transforms daily notes into organized, searchable knowledge.

aiclaudegptmcpmcp-server
Share:
36
Stars
0
Downloads
0
Weekly
0/5

What is MCP Note-Taking System?

MCP Note-Taking System is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to personal knowledge management system built on the model context protocol that transforms daily notes into organized, searchable knowledge.

A personal knowledge management system built on the Model Context Protocol that transforms daily notes into organized, searchable knowledge.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A personal knowledge management system built on the Model Co

Use Cases

Personal knowledge management
Searchable note system
9Ninety

Maintainer

LicenseGPL 2.0
Languagetypescript
Versionv1.0.0
UpdatedApr 25, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y mcp-notes

Manual Installation

npx -y mcp-notes

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Note-Taking System

MCP Notes is a personal knowledge management system that stores and retrieves notes using AWS DynamoDB as a persistent backend, exposed through the Model Context Protocol. It provides four tools — listNotes, getNote, writeNote, and deleteNote — allowing AI assistants to read, create, update, and delete notes with titles, summaries, tags, and Markdown content. Individuals and developers use it to build a searchable, AI-accessible knowledge base that persists across conversations and can be queried by tag or browsed by any MCP-compatible client.

Prerequisites

  • Node.js 18 or higher installed (for npx usage)
  • An AWS account with DynamoDB access — the free tier is sufficient for personal use
  • AWS credentials: AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY with DynamoDB permissions
  • A DynamoDB table created in your chosen AWS region to store notes
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Create a DynamoDB table in AWS

Log in to the AWS Console and create a new DynamoDB table for your notes. Set the partition key to 'id' (String). Note the table name and the region where you created it.

2

Obtain AWS credentials

Create an IAM user or role with DynamoDB permissions (at minimum: dynamodb:GetItem, dynamodb:PutItem, dynamodb:DeleteItem, dynamodb:Scan). Generate an access key ID and secret access key for that user.

3

Test the server with npx

Run the MCP Notes server using npx with a DynamoDB connection URI that embeds your credentials, region, and table name.

npx -y -p mcp-notes mcp-notes-server --dynamodb "dynamodb://ACCESS_KEY:SECRET_KEY@us-east-1/my-notes-table"
4

Configure your MCP client

Add MCP Notes to your Claude Desktop configuration, passing the DynamoDB URI as an argument.

{
  "mcpServers": {
    "notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://ACCESS_KEY:SECRET_KEY@us-east-1/my-notes-table"
      ]
    }
  }
}
5

Use environment variables for credentials (recommended)

Instead of embedding credentials in the URI, export AWS environment variables and pass a credential-free URI. This keeps secrets out of your config file.

export AWS_ACCESS_KEY_ID="your_access_key"
export AWS_SECRET_ACCESS_KEY="your_secret_key"
# Then use URI without credentials:
npx -y -p mcp-notes mcp-notes-server --dynamodb "dynamodb://us-east-1/my-notes-table"
6

Launch the optional web interface

MCP Notes also ships a web server for browsing notes in a browser at http://localhost:3100.

npx -p mcp-notes mcp-notes-web-server --dynamodb "dynamodb://ACCESS_KEY:SECRET_KEY@us-east-1/my-notes-table"

MCP Note-Taking System Examples

Client configuration

Claude Desktop configuration for MCP Notes using a DynamoDB URI with embedded credentials.

{
  "mcpServers": {
    "notes": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "mcp-notes",
        "mcp-notes-server",
        "--dynamodb",
        "dynamodb://AKIAIOSFODNN7EXAMPLE:wJalrXUtnFEMI@us-east-1/my-mcp-notes"
      ]
    }
  }
}

Prompts to try

Example prompts demonstrating note creation, retrieval, and tag-based search.

- "Save a note titled 'MCP Setup Notes' with tags ['mcp', 'setup'] summarizing what I just learned"
- "List all my notes tagged with 'project'"
- "Find and show me the note about AWS DynamoDB configuration"
- "Update the note on TypeScript generics to include an example of conditional types"
- "Delete the note with the title 'Old Meeting Agenda'"

Troubleshooting MCP Note-Taking System

Connection errors or access denied when connecting to DynamoDB

Verify your AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are correct and that the IAM user has DynamoDB permissions. Also confirm the region in your connection URI matches the region where you created the table.

Notes are saved but listNotes returns an empty result

Check that the table name in your DynamoDB URI exactly matches the table name in AWS (case-sensitive). Also ensure the IAM policy includes dynamodb:Scan permission, which is required for listing all notes.

npx command not found or version conflicts

Ensure Node.js 18+ is installed. The package requires the -p mcp-notes flag before the command mcp-notes-server because the binary name differs from the package name. Use the exact command: npx -y -p mcp-notes mcp-notes-server.

Frequently Asked Questions about MCP Note-Taking System

What is MCP Note-Taking System?

MCP Note-Taking System is a Model Context Protocol (MCP) server that personal knowledge management system built on the model context protocol that transforms daily notes into organized, searchable knowledge. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Note-Taking System?

Install via npm with the command: npx -y mcp-notes. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with MCP Note-Taking System?

MCP Note-Taking System works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Note-Taking System free to use?

Yes, MCP Note-Taking System is open source and available under the GPL 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-notes": { "command": "npx", "args": ["-y", "mcp-notes"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Note-Taking System?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides