Skip to main content
Glama

Note Post MCP

by Go-555

Note Post MCP

GitHub

The Universal MCP Server exposes tools for automated posting and draft saving to note.com. It reads Markdown files containing titles, body text, and tags, then publishes them to your note.com account using Playwright automation.

Installation

Prerequisites

  • Node.js 18+

  • A note.com account

  • note-state.json authentication state file (obtained via separate login script)

  • Set NOTE_POST_MCP_STATE_PATH in your environment (optional, defaults to ~/.note-state.json)

Get an authentication state file

  • You need to obtain a note-state.json file containing your note.com authentication state.

  • This can be generated using a Playwright login script that saves the browser's storage state after successful authentication.

  • Store this file securely and reference it via NOTE_POST_MCP_STATE_PATH or pass it as a parameter.

Install from GitHub

git clone https://github.com/Go-555/note-post-mcp.git cd note-post-mcp npm install npm run build

Or install from npm (if published)

npm install -g note-post-mcp

Setup: Claude Code (CLI)

Use this one-liner (replace with your real values):

claude mcp add Note Post MCP -s user -e NOTE_POST_MCP_STATE_PATH="/path/to/note-state.json" -- npx note-post-mcp

To remove:

claude mcp remove Note Post MCP

Setup: Cursor

Create .cursor/mcp.json in your client (do not commit it here):

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

Other Clients and Agents

Install via URI or CLI:

code --add-mcp '{"name":"note-post-mcp","command":"npx","args":["note-post-mcp"],"env":{"NOTE_POST_MCP_STATE_PATH":"/path/to/note-state.json"}}'

Add to your Claude Desktop configuration file (claude_desktop_config.json):

{ "mcpServers": { "note-post-mcp": { "command": "npx", "args": ["note-post-mcp"], "env": { "NOTE_POST_MCP_STATE_PATH": "/path/to/note-state.json" } } } }
  • Command: npx

  • Args: ["note-post-mcp"]

  • Env: NOTE_POST_MCP_STATE_PATH=/path/to/note-state.json

  • Type: STDIO

  • Command: npx

  • Args: note-post-mcp

  • Enabled: true

Example ~/.config/opencode/opencode.json:

{ "$schema": "https://opencode.ai/config.json", "mcp": { "note-post-mcp": { "type": "local", "command": ["npx", "note-post-mcp"], "enabled": true, "env": { "NOTE_POST_MCP_STATE_PATH": "/path/to/note-state.json" } } } }

Add a new MCP and paste the standard JSON config from above.

Add the following to your Windsurf MCP configuration:

{ "note-post-mcp": { "command": "npx", "args": ["note-post-mcp"], "env": { "NOTE_POST_MCP_STATE_PATH": "/path/to/note-state.json" } } }

Setup: Codex (TOML)

Add the following to your Codex TOML configuration.

Example (Serena):

[mcp_servers.serena] command = "uvx" args = ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "codex"]

This server (minimal):

[mcp_servers.note-post-mcp] command = "npx" args = ["note-post-mcp"] # Optional environment variables: # NOTE_POST_MCP_STATE_PATH = "/path/to/note-state.json" # NOTE_POST_MCP_TIMEOUT = "180000" # MCP_NAME = "note-post-mcp"

Configuration (Env)

  • NOTE_POST_MCP_STATE_PATH: Path to the note.com authentication state file (default: ~/.note-state.json)

  • NOTE_POST_MCP_TIMEOUT: Timeout in milliseconds for browser operations (default: 180000)

  • MCP_NAME: Server name override (default: note-post-mcp)

Available Tools

publish_note

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

  • Inputs:

    • markdown_path (string, required): Path to the Markdown file containing title, body, and tags

    • thumbnail_path (string, optional): Path to the thumbnail image file

    • state_path (string, optional): Path to the note.com authentication state file

    • screenshot_dir (string, optional): Directory to save screenshots

    • timeout (number, optional): Timeout in milliseconds

  • Outputs: JSON object with:

    • success (boolean): Whether the operation succeeded

    • url (string): URL of the published article

    • screenshot (string): Path to the screenshot

    • message (string): Success message

save_draft

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

  • Inputs:

    • markdown_path (string, required): Path to the Markdown file containing title, body, and tags

    • thumbnail_path (string, optional): Path to the thumbnail image file

    • state_path (string, optional): Path to the note.com authentication state file

    • screenshot_dir (string, optional): Directory to save screenshots

    • timeout (number, optional): Timeout in milliseconds

  • Outputs: JSON object with:

    • success (boolean): Whether the operation succeeded

    • url (string): URL of the draft editor page

    • screenshot (string): Path to the screenshot

    • message (string): Success message

Markdown File Format

Your Markdown file should follow this format:

--- title: Your Article Title tags: - tag1 - tag2 --- Your article body content goes here. You can include URLs and they will be automatically expanded by note.com.

Alternatively, you can use array notation for tags:

--- title: Your Article Title tags: [tag1, tag2] --- Your article body content goes here.

Or use a simple # heading for the title if no front matter is present:

# Your Article Title Your article body content goes here.

Example invocation (MCP tool call)

{ "name": "publish_note", "arguments": { "markdown_path": "/path/to/article.md", "thumbnail_path": "/path/to/thumbnail.png", "state_path": "/path/to/note-state.json" } }

For saving a draft:

{ "name": "save_draft", "arguments": { "markdown_path": "/path/to/draft.md" } }

Troubleshooting

  • Authentication errors: Ensure your note-state.json file is valid and up-to-date. You may need to regenerate it if your session has expired.

  • Ensure Node 18+: Run node -v to verify your Node.js version.

  • Build errors: Run npm install and npm run build to ensure all dependencies are installed and TypeScript is compiled.

  • Local runs: After building, test locally with npx note-post-mcp (it will wait for MCP messages on stdin).

  • Inspect publish artifacts: Run npm pack --dry-run to see what files will be included in the published package.

  • Timeout issues: If operations are timing out, increase NOTE_POST_MCP_TIMEOUT or pass a larger timeout parameter.

  • Playwright browser not installed: Run npx playwright install chromium to install the required browser.

References

Name Consistency & Troubleshooting

  • Always use CANONICAL_ID (note-post-mcp) for identifiers and keys.

  • Use CANONICAL_DISPLAY (Note Post MCP) only for UI labels.

  • Do not mix different names across clients.

Consistency Matrix

  • npm package name → note-post-mcp

  • Binary name → note-post-mcp

  • MCP server name (SDK metadata) → note-post-mcp

  • Env default MCP_NAME → note-post-mcp

  • Client registry key → note-post-mcp

  • UI label → Note Post MCP

Conflict Cleanup

  • Remove any old entries with different names and re-add with note-post-mcp.

  • Ensure global .mcp.json or client registries only use note-post-mcp for keys.

  • Cursor: Configure in the UI only. This project does not include .cursor/mcp.json.

Example

  • Correct: "mcpServers": { "note-post-mcp": { "command": "npx", "args": ["note-post-mcp"] } }

  • Incorrect: Using different keys like "NotePost" or "note_post" (will conflict with note-post-mcp)

License

MIT

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables automated publishing and draft saving to note.com platform using Playwright automation. Reads Markdown files with titles, body text, and tags to publish content directly to your note.com account.

  1. Installation
    1. Prerequisites
    2. Get an authentication state file
    3. Install from GitHub
    4. Or install from npm (if published)
  2. Setup: Claude Code (CLI)
    1. Setup: Cursor
      1. Other Clients and Agents
        1. Setup: Codex (TOML)
          1. Configuration (Env)
            1. Available Tools
              1. publish_note
              2. save_draft
            2. Markdown File Format
              1. Example invocation (MCP tool call)
                1. Troubleshooting
                  1. References
                    1. Name Consistency & Troubleshooting
                      1. Consistency Matrix
                      2. Conflict Cleanup
                      3. Example
                    2. License

                      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/Go-555/note-post-mcp'

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