MCPNotes

MCP Notes provides a dual-server setup: a Node.js MCP server for AI-driven note management and a web server that offers a user-friendly interface for manual note interaction. The MCP server accepts tool calls to create, list, retrieve, update, and delete notes using the integrated MCP tools (listNotes, getNote, writeNote, deleteNote). You can drive these actions via MCP-enabled clients or Claude Desktop/Cody integrations described in the README. The web interface makes it easy to compose notes, assign tags, and manage content, while the MCP server enables AI-assisted note capture and retrieval during conversations. To get started, run the MCP server with your DynamoDB-backed configuration and then connect your client or Claude Desktop to perform operations like listing notes or writing new ones through natural language prompts.

Prerequisites:

• Node.js (recommended version compatible with the project)
• npm or bun
• AWS account with DynamoDB access (or a DynamoDB-compatible endpoint)

Installation steps:

1. Install dependencies and start the MCP server:

# Using npx (recommended for quick starts)
npx -y -p mcp-notes mcp-notes-server --dynamodb dynamodb://<access_key>:<secret_key>@<region>/<table>

2. Alternatively, install locally and run:

# Clone the repo
git clone https://github.com/your-org/mcp-notes.git
cd mcp-notes

# Install dependencies
npm install

# Start the MCP server (adjust path and dynamodb as needed)
npx -y -p mcp-notes mcp-notes-server --dynamodb dynamodb://<access_key>:<secret_key>@<region>/<table>

3. Start the web interface (if separate web server is provided):

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

4. Open the web UI at http://localhost:3100 and begin managing notes.

Tips and considerations:

• Ensure your DynamoDB table exists and is accessible from your environment. The UI and MCP server rely on this storage for notes.
• You can supply AWS credentials via environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY) or embed credentials in the DynamoDB URI (not recommended for production).
• The MCP server supports multiple models that can call functions; verify your client supports function calls in MCP to use AI-powered note operations.
• When using npx with -p mcp-notes, ensure your network allows fetching the package and that your Node.js version is compatible with the package requirements.
• If you encounter connection issues, double-check DynamoDB endpoint region and table name in both the URI and resource permissions.