Skip to main content
Glama
nonz250

notepm-mcp-server

by nonz250
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
2wRelease cycle
10Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nonz250/notepm-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server