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

1. Go to NotesKeep
2. Register or Login
3. Go to Settings (gear icon in the header)
4. Click Generate API Key
5. 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

• NotesKeep App
• GitHub Repository
• Report Issues

License

MIT