1. Conduid
  2. Developer Tools
  3. notepm-server
MCP server · Developer Tools

notepm-server

by · github.com/nonz250/notepm-mcp-server

An unofficial MCP server for NotePM - a knowledge management platform

Unclaimed mcpnotepmmodel-context-protocolclaudeaiknowledge-management
InstallView source
39Low

Scored yesterday · breakdown

About notepm-server

notepm-server is an MCP server published by git+nonz250 in the Developer Tools category: an unofficial MCP server for NotePM - a knowledge management platform.

The repository has 1 stars and 0 forks, with the last commit 7 days ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Install
npx @nonz250/notepm-mcp-server
Claude Code
claude mcp add notepm-mcp-server -- npx -y @nonz250/notepm-mcp-server
npx
npx -y @nonz250/notepm-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (8)

create_pageCreate a new page in a specified note

Parameters not published.

create_tagCreate a new tag

Parameters not published.

get_pageGet a page's full content including title, body, and tags

Parameters not published.

list_foldersList folders in a note with hierarchy

Parameters not published.

list_notesList all notes in your workspace

Parameters not published.

list_tagsList all tags in your workspace

Parameters not published.

search_pagesSearch pages by keyword, note, or tag

Parameters not published.

update_pageUpdate an existing page's content

Parameters not published.

Ask AI

✦

Ask AI about notepm-server

Powered by Claude · Grounded in docs

I know everything about notepm-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

README

notepm-mcp-server

An unofficial Model Context Protocol (MCP) server for NotePM - a knowledge management and documentation platform.

This server enables AI assistants like Claude to search, read, create, and update pages in your NotePM workspace.

Requirements

  • Node.js >= 24

Installation

Using npx (Recommended)

No installation required. Configure your MCP client to run the server directly with npx.

Global Installation

npm install -g @nonz250/notepm-mcp-server

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "notepm": {
      "command": "npx",
      "args": ["-y", "@nonz250/notepm-mcp-server"],
      "env": {
        "NOTEPM_TEAM_DOMAIN": "your-team-domain",
        "NOTEPM_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Claude Code

Using CLI

claude mcp add notepm \
  --env NOTEPM_TEAM_DOMAIN=your-team-domain \
  --env NOTEPM_ACCESS_TOKEN=your-access-token \
  -- npx -y @nonz250/notepm-mcp-server

Using settings file

Add the following to your Claude Code settings file (.claude/settings.json or .claude/settings.local.json):

{
  "mcpServers": {
    "notepm": {
      "command": "npx",
      "args": ["-y", "@nonz250/notepm-mcp-server"],
      "env": {
        "NOTEPM_TEAM_DOMAIN": "your-team-domain",
        "NOTEPM_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Codex CLI

codex mcp add notepm \
  --env NOTEPM_TEAM_DOMAIN=your-team-domain \
  --env NOTEPM_ACCESS_TOKEN=your-access-token \
  -- npx -y @nonz250/notepm-mcp-server

Using Global Installation

If you installed globally, replace npx with the direct command:

{
  "mcpServers": {
    "notepm": {
      "command": "notepm-mcp-server",
      "env": {
        "NOTEPM_TEAM_DOMAIN": "your-team-domain",
        "NOTEPM_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Available Tools

Tool Description
list_folders List folders in a note with hierarchy
list_notes List all notes in your workspace
search_pages Search pages by keyword, note, or tag
get_page Get a page's full content including title, body, and tags
create_page Create a new page in a specified note
update_page Update an existing page's content
list_tags List all tags in your workspace
create_tag Create a new tag

Environment Variables

Variable Required Description
NOTEPM_TEAM_DOMAIN Yes Your NotePM team domain (e.g., demo for demo.notepm.jp)
NOTEPM_ACCESS_TOKEN Yes API access token from NotePM

Getting an Access Token

  1. Log in to your NotePM workspace
  2. Go to Personal Settings > Access Token
  3. Generate a new access token
  4. Copy the token and use it in your configuration

Development

Using MCP Server Locally

When developing this package, npx @nonz250/notepm-mcp-server won't work from within the project directory. Use the local build instead:

claude mcp add notepm \
  --env NOTEPM_TEAM_DOMAIN=your-team-domain \
  --env NOTEPM_ACCESS_TOKEN=your-access-token \
  -- npm run start --prefix /path/to/notepm-mcp-server

codex mcp add notepm \
  --env NOTEPM_TEAM_DOMAIN=your-team-domain \
  --env NOTEPM_ACCESS_TOKEN=your-access-token \
  -- npm run start --prefix /path/to/notepm-mcp-server

Setup

git clone https://github.com/nonz250/notepm-mcp-server.git
cd notepm-mcp-server
npm install
npm run build

Running Locally

NOTEPM_TEAM_DOMAIN=your-team NOTEPM_ACCESS_TOKEN=your-token npm run start

Running Tests

npm test

Linting and Formatting

npm run lint
npm run format

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About notepm-server

How do I install notepm-server?

Run npx @nonz250/notepm-mcp-server, then add the server to your MCP client's configuration.

Is notepm-server safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is notepm-server still maintained?

Yes — the last commit was 7 days ago. The repository has 1 stars and 0 forks.