Notepm MCP Server

🚀 NotePM MCP Server

A server for searching NotePM content via the Model Context Protocol (MCP). Use this server to access NotePM's search functionality through MCP-compatible clients.

🚀 Quick Start

This server enables users to search NotePM content via the Model Context Protocol (MCP). With an MCP-compatible client, you can easily access NotePM's search features.

✨ Features

• Full-text search of NotePM content
• Title-only search
• Tag search
• Note code search
• Archive page search option
• Pagination support
• Retrieve detailed article content

📦 Installation

Prerequisites

• Python 3.12 or higher
• A NotePM account and API Token
• uv

Steps

uv sync

🔧 Configuration

Environment Variables

You need to set the following environment variables:

• NOTEPM_TEAM: Your NotePM team name
• NOTEPM_API_TOKEN: Your NotePM API token

You can also create a .env file for configuration:

NOTEPM_TEAM=your-team-name
NOTEPM_API_TOKEN=your-api-token

💻 Usage Examples

Starting the Server

uv run notepm-mcp-server

Configuring the MCP Client

"servers": {
  "notepm-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/<Path to mcp-servers>/notepm-mcp-server",
      "run",
      "notepm-mcp-server"
    ],
    "env": {
      "NOTEPM_TEAM": "your-team-name",
      "NOTEPM_API_TOKEN": "your-api-token"
    }
  }
}