NotesKeep MCP Server
MCP (Model Context Protocol) server for NotesKeep - interact with your notes via Claude Code.
Installation
npm install -g noteskeep-mcp
Or use directly with npx:
npx noteskeep-mcp
Setup
1. Get your API Key
- Go to NotesKeep
- Register or Login
- Go to Settings (gear icon in the header)
- Click Generate API Key
- Copy the generated key
2. Configure Claude Code
Option A: Using CLI (recommended)
claude mcp add --transport stdio noteskeep --scope user \
--env NOTESKEEP_API_KEY=your_api_key_here \
-- npx noteskeep-mcp
Option 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"
}
}
}
}
3. Restart Claude Code
After adding the configuration, restart Claude Code to load the MCP server.
Available Tools
| Tool | Description |
|---|---|
list_notes | List your notes (with optional limit and archive filter) |
get_note | Get a specific note by ID |
create_note | Create a new note (text or checklist) |
update_note | Update a note's content, title, or color |
delete_note | Delete a note |
archive_note | Archive a note |
pin_note | Pin or unpin a note |
Environment Variables
| Variable | Required | Description |
|---|---|---|
NOTESKEEP_API_KEY | Yes | Your NotesKeep API key |
NOTESKEEP_API_URL | No | Custom API URL (defaults to https://noteskeep.vercel.app) |
Usage Examples
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"
Note Types
NotesKeep supports two types of notes:
- Text notes: Simple notes with a title and content
- Checklist notes: Notes with checkable items
Note Colors
Available colors: white, gray, yellow, orange, teal, blue, purple, pink
Development
# 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 build
Links
License
MIT