MCPNotes MCP Server

A simple note-taking MCP server for recording and managing notes with AI models.

Local serverstdio

What is the MCPNotes MCP server?

Mcpnotes mcp server lets Claude, Cursor and other MCP clients work with MCPNotes directly. A simple note-taking MCP server for recording and managing notes with AI models.

What MCPNotes does

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.

Tools it exposes

Once connected, the assistant can call these 6 tools directly:

  • Cody — The Cody tool exposed by this server
  • Cline — The Cline tool exposed by this server
  • listNotes — The listNotes tool exposed by this server
  • getNote — The getNote tool exposed by this server
  • writeNote — The writeNote tool exposed by this server
  • deleteNote — The deleteNote tool exposed by this server

Installing the mcpnotes mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 2 environment variables: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Productivity servers pay off through capture: the tasks and notes that never get filed are the ones where opening the app is more friction than the thought is worth. MCPNotes sits in that group, and the shape of its toolset — Cody, Cline, listNotes among others — tells you what it is really for. Worth comparing against the other productivity servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by 9Ninety.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the mcpnotes mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
CodyThe Cody tool exposed by this server.
ClineThe Cline tool exposed by this server.
listNotesThe listNotes tool exposed by this server.
getNoteThe getNote tool exposed by this server.
writeNoteThe writeNote tool exposed by this server.
deleteNoteThe deleteNote tool exposed by this server.

How to install the MCPNotes MCP server

or file on local disks:

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
AWS_ACCESS_KEY_IDCredential the server authenticates with.Yes
AWS_SECRET_ACCESS_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use MCPNotes to Cody.
  • Use MCPNotes to Cline.
  • Use MCPNotes to listNotes.

Frequently asked questions

It connects MCPNotes to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (Cody, Cline, listNotes, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCPNotes directly.