Note Post

Note Post MCP Server provides an automated way to publish Markdown-based articles to note.com or save them as drafts. It runs as a local MCP and uses Playwright under the hood to control a browser, making it easy to post content from your workflow or editor.

How to use

You run the Note Post MCP server alongside your editor or automation client. Configure a local MCP entry that launches the MCP with the correct environment so it can access your note.com authentication state. Use an MCP client to send publish_note or save_draft commands, providing a Markdown file and optional thumbnail, then receive a URL to the published post or draft editor.

Key concepts you’ll use repeatedly are the following tool endpoints: publish_note Publishes an article to note.com from a Markdown file. save_draft Saves a draft article to note.com from a Markdown file.

To start, ensure you have Node.js 18 or later, a note.com account, and an authentication state file created by running a login step. Then run the MCP client or integration that invokes the Note Post MCP server and pass the markdown_path and optional parameters.

How to install

Prerequisites you need: Node.js 18+ and a note.com account. You also need a note-state file generated after logging in.

# 1) Install from npm (recommended if published)
npm i -g note-post-mcp

# 2) If you prefer local usage, clone the repo (replace with your real URL)
# git clone https://github.com/Go-555/note-post-mcp.git
# cd note-post-mcp
# npm install
# npm run build

# 3) Install the required browser for Playwright
npm run install-browser

# 4) Create the authentication state file
npm run login

After you have the state file, reference it with NOTE_POST_MCP_STATE_PATH or pass it through the client. The default path is ~/.note-state.json if you don’t override it.

If you install via npm, you can also run the MCP directly with the published package when needed.

Configuration and usage details

Set the authentication state path in your environment to point to your note.com login state file. You can override the default path by exporting NOTE_POST_MCP_STATE_PATH.

Override timeout for browser operations using NOTE_POST_MCP_TIMEOUT. The default is 180000 ms.

You can name the MCP server with MCP_NAME to customize how it appears in your clients.

Standalone MCP configuration (stdio)

The following configuration launches the MCP server locally as a stdio process using npx and the published package. It uses an environment variable to locate your authentication state file.

{
  "mcpServers": {
    "note-post-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@gonuts555/note-post-mcp@latest"],
      "env": {
        "NOTE_POST_MCP_STATE_PATH": "/path/to/note-state.json"
      },
      "autoStart": true
    }
  }
}

Codex, Cursor, and other client setups

You can add the Note Post MCP server to your Codex TOML configuration or Cursor setup to run automatically in your client workspace.

Codex example shows how to declare the server in TOML with the same command and environment settings.

Markdown File Format and tool usage

Your Markdown file should include a front matter block with title and tags, or you can use a leading H2 heading as the article title. The content body follows after the front matter. Note that You can include URLs that will be expanded by note.com.

Tools provided by this MCP include publish_note for publishing content and save_draft for saving a draft.

Troubleshooting

Authentication errors usually indicate an invalid or expired note-state.json. Regenerate the state file by running the login step again and ensure NOTE_POST_MCP_STATE_PATH points to the correct file.

Verify you are using Node.js version 18 or newer by running node -v.

If you encounter build issues, run npm install and npm run build to ensure dependencies are installed and TypeScript is compiled.

Appendix: Tools and endpoints

Available tools include publish_note which publishes an article to note.com from a Markdown file, and save_draft which saves a draft article to note.com from a Markdown file.

Available tools

publish_note

Publishes an article to note.com from a Markdown file.

save_draft

Saves a draft article to note.com from a Markdown file.