notepadpp-mcp
Allows opening files, checking editor status, and saving/loading session snapshots in Notepad++.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@notepadpp-mcp Open my notes.txt"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@mhdd_24/notepadpp-mcp
MCP server for Notepad++ on Windows. Use it from Cursor, Claude Desktop, VS Code Copilot, or any MCP-compatible client to open files, check editor status, and save/load session snapshots.
Full documentation: docs/WIKI.md
How it works (30 seconds)
You (chat) → MCP client → notepadpp-mcp → notepad++.exe / session.xmlStatus — resolves
NOTEPADPP_EXE, checks if the process is runningOpen / new — launches Notepad++ with file paths or a fresh buffer
Sessions — reads live
session.xml; save/load named snapshots via-openSession
Related MCP server: technical-notes-mcp
Prerequisites
Requirement | Notes |
Node.js 18+ | Required for MCP server |
Notepad++ 8+ | Default: |
Windows | CLI + |
Install
Option A — npm (recommended after publish)
npm install -g @mhdd_24/notepadpp-mcpOption B — npx (no global install)
npx @mhdd_24/notepadpp-mcpOption C — clone and build (contributors)
git clone https://github.com/Mhdd-24/NotePadpp-MCP.git
cd NotePadpp-MCP
npm install
npm run build
node dist/index.jsConfigure your MCP client
Cursor
Edit Cursor Settings → MCP or ~/.cursor/mcp.json:
{
"mcpServers": {
"notepadpp": {
"command": "npx",
"args": ["-y", "@mhdd_24/notepadpp-mcp"],
"env": {
"NOTEPADPP_EXE": "C:/Program Files/Notepad++/notepad++.exe",
"NOTEPADPP_WORKDIR": "C:/Users/You/Documents/NotepadPP-Notes"
}
}
}
}After global install, you can use:
"command": "notepadpp-mcp"Local development:
"command": "node",
"args": ["C:/path/to/notepadpp-mcp/dist/index.js"]Restart Cursor (or toggle the MCP server off/on) after saving.
Environment variables
Variable | Required | Default | Purpose |
| No | Program Files path | Path to |
| No |
| Base for relative paths |
| No |
| Live session file |
| No |
| Named snapshots |
Never commit machine-specific paths that identify private orgs. Put local overrides only in MCP env or a gitignored .env.
Tools
Tool | Purpose |
| Exe path, process running, session/workdir |
| Open file(s) in Notepad++ |
| New empty buffer or create+open a file |
| List paths from live |
| Snapshot live session under a name |
| Load named session via |
| Escape hatch with custom CLI args |
What happens after npm install?
Package files land in
node_modules/@mhdd_24/notepadpp-mcp/(or global prefix if-g).prepack/ publish includes compileddist/— no local build needed for end users.The
notepadpp-mcpbin points todist/index.js.Your MCP client runs that entry over stdio.
Tools are registered; the server waits for
CallToolrequests from the AI.
After publishing to npm (maintainers)
Bump version in
package.jsonandsrc/config/notepadpp.config.ts(NPP.SERVER.VERSION).Build and test:
npm run buildthen test with localmcp.json.Publish:
npm publish --access public(logged in as package owner).Users update by restarting MCP —
npxpicks up the new version automatically.
Current package version: 1.0.1.
See WIKI — Publishing for the checklist.
Troubleshooting
Problem | Fix |
Exe not found | Set |
Empty session list | Open saved files in Notepad++, then retry |
Session load opens new window | Check Notepad++ multi-instance preferences |
License
ISC
Available Tools
7 toolsnpp_list_sessionA
List file paths from the live Notepad++ session.xml (open/recent buffers).
Inputs: no named parameters.
npp_load_sessionC
Load a named session snapshot via notepad++.exe -openSession.
Inputs: name (required).
npp_newB
Launch Notepad++ with a new empty document. Optionally create and open a new file under NOTEPADPP_WORKDIR.
Inputs: filename, multiInstance.
npp_openA
Open one or more files in Notepad++. Paths may be absolute or relative to NOTEPADPP_WORKDIR.
Inputs: paths (required), multiInstance.
npp_runB
Escape hatch: run notepad++.exe with custom CLI arguments.
Inputs: args.
npp_save_sessionB
Copy the live session.xml into a named snapshot under the session storage folder.
Inputs: name (required).
npp_statusA
Check Notepad++ availability: exe path, whether the process is running, and resolved session/workdir paths.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct operation: listing sessions, loading sessions, creating new documents, opening files, running custom commands, saving sessions, and checking status. There is no functional overlap.
All tools use the 'npp_' prefix followed by a descriptive verb_noun pattern (e.g., list_session, load_session, save_session). 'npp_new' is slightly inconsistent as 'new' is an adjective, but still follows the pattern.
Seven tools cover the essential operations for Notepad++ session and file management without being excessive or insufficient for the server's purpose.
The set covers session management (list, load, save), file operations (new, open), and system integration (run, status). Minor gaps like closing files or editing are absent but not critical for the core use case.
Maintenance
Related MCP Connectors
An MCP server that used to create notes
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides tools for reading, writing, and editing files on the local filesystem.1,605Apache 2.0
- AlicenseAqualityDmaintenanceMCP server that allows searching a local notes directory and retrieving live CPU and memory usage.2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for SSH remote execution, file transfer, and file editing with automatic backup/trash and ~/.ssh/config integration.117 npm1MIT
- AlicenseAqualityDmaintenanceMCP server for Garry's Mod enabling RCON command execution, Lua scripting, window control, screenshots, and SFTP file management.1635 npm1MIT