Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@NotesKeep MCP Server create a checklist note for my grocery list with milk, eggs, and bread"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP (Model Context Protocol) server for NotesKeep - interact with your notes via Claude Code.
npm install -g noteskeep-mcpOr use directly with npx:
npx noteskeep-mcpRelated MCP server: Voicenotes MCP
Go to NotesKeep
Register or Login
Go to Settings (gear icon in the header)
Click Generate API Key
Copy the generated key
Option A: Using CLI (recommended)
claude mcp add --transport stdio noteskeep --scope user \
--env NOTESKEEP_API_KEY=your_api_key_here \
-- npx noteskeep-mcpOption B: Manual configuration
Add to your ~/.claude.json under the mcpServers section:
{
"mcpServers": {
"noteskeep": {
"type": "stdio",
"command": "npx",
"args": ["noteskeep-mcp"],
"env": {
"NOTESKEEP_API_KEY": "your_api_key_here"
}
}
}
}After adding the configuration, restart Claude Code to load the MCP server.
Tool | Description |
| List your notes (with optional limit and archive filter) |
| Get a specific note by ID |
| Create a new note (text or checklist) |
| Update a note's content, title, or color |
| Delete a note |
| Archive a note |
| Pin or unpin a note |
Variable | Required | Description |
| Yes | Your NotesKeep API key |
| No | Custom API URL (defaults to https://noteskeep.vercel.app) |
Once configured, you can ask Claude:
"List my notes"
"Create a note titled 'Shopping List' with items: milk, eggs, bread"
"Show me note 5"
"Pin note 3"
"Archive note 7"
"Update note 2 with new content: Meeting notes from today"
"Create a checklist note for my weekend tasks"
NotesKeep supports two types of notes:
Text notes: Simple notes with a title and content
Checklist notes: Notes with checkable items
Available colors: white, gray, yellow, orange, teal, blue, purple, pink
# Clone the repository
git clone https://github.com/mariomosca/noteskeep-mcp.git
cd noteskeep-mcp
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build
npm run buildMIT
Inputs: noteId (required), labelId (required).
Inputs: id (required).
Inputs: name (required), color.
Inputs: title (required), content, type, checklist, +2 more.
Inputs: id (required).
Inputs: id (required).
Inputs: id (required).
Inputs: noteId (required).
Inputs: no named parameters.
Inputs: limit, includeArchived.
Inputs: id (required), pinned.
Inputs: noteId (required), labelId (required).
Inputs: noteId (required), labelIds (required).
Inputs: id (required), title, content, isPinned, +3 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 14 tools
Every tool has a clearly distinct purpose targeting specific note or label operations with no ambiguity. For example, 'add_label_to_note' and 'remove_label_from_note' are complementary but distinct actions, while 'get_note_labels' and 'set_note_labels' serve different query vs. modification functions.
All tools follow a consistent verb_noun pattern with snake_case throughout, such as 'create_note', 'delete_label', and 'list_notes'. The naming is predictable and readable, with no deviations in style or convention across the set.
With 14 tools, this server is well-scoped for a notes management domain, covering CRUD operations for notes and labels, plus additional utilities like archiving and pinning. Each tool earns its place without feeling excessive or insufficient for the apparent functionality.
The tool set provides complete CRUD/lifecycle coverage for notes and labels, including creation, retrieval, updating, deletion, listing, and specialized actions like archiving and pinning. There are no obvious gaps, and agents can handle full workflows without dead ends.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Search, read, create and edit your Memol notes from Claude. Team note-taking with AI search.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
