NotePM MCP Server

Name: NotePM MCP Server
Author: k-ibaraki

@k-ibaraki

Repository

About NotePM MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notepm-mcp-server": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is NotePM MCP Server?

NotePM MCP Server is a Model Context Protocol (MCP) server that enables MCP‑compatible clients to search and retrieve content from NotePM, a knowledge management platform. It is designed for users who want to integrate NotePM search capabilities into AI‑assisted workflows.

How to use NotePM MCP Server?

Install the server with uv sync, set the required environment variables (NOTEPM_TEAM and NOTEPM_API_TOKEN), and start the server with uv run notepm-mcp-server. Configure your MCP client using the provided JSON settings with the uv command, directory path, and environment variables.

Key features of NotePM MCP Server

Full‑text search of NotePM content
Search by title only
Search by tags
Search by note code
Option to include archived pages
Pagination support for search results
Retrieve detailed article content

Use cases of NotePM MCP Server

Search for notes across a NotePM team from an MCP client (e.g., an AI assistant)
Find articles by title, tag, or note code quickly
Retrieve full content of a specific note for further processing
Include archived pages in search results when needed
Paginate through large result sets efficiently

FAQ from NotePM MCP Server

What are the prerequisites to use NotePM MCP Server?

You need Python 3.12 or later, the uv package manager, and a valid NotePM account with an API token.

How do I set up the environment variables?

Create a .env file with NOTEPM_TEAM (your team name) and NOTEPM_API_TOKEN (your API token), or export them directly in your shell.

How do I start the server?

Run uv run notepm-mcp-server from the server directory.

How do I configure an MCP client to use this server?

Use the JSON configuration with "command": "uv", "args": ["--directory", "/path/to/notepm-mcp-server", "run", "notepm-mcp-server"], and "env" containing NOTEPM_TEAM and NOTEPM_API_TOKEN.