io.github.Coooolinz/why-note

why-note-mcp

Read-only search, todo listing, and daily note access for a WhyNote account

71/wk 9 tools GitHub npm

No known CVEs

MIT license

Actively maintained

Last commit 13d ago

Works with most clients

Transport: stdio

9 tools · ~258 tok

Grade A · 0.1% of 200K ctx

MCPpedia last refreshed this data 21h ago

Edit this pageView history

io.github.Coooolinz/why-note is an MCP server that read-only search, todo listing, and daily note access for a WhyNote account. Its tool list has not been published yet over stdio, requires no API key, and scores 85/100 on MCPpedia's security, maintenance and efficiency rubric.

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "note": {
      "env": {
        "NOTE_URL": "https://note.example.com",
        "NOTE_TOKEN": "<read-only-token>"
      },
      "args": [
        "-y",
        "why-note-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-coooolinz-why-note)](https://mcppedia.org/s/io-github-coooolinz-why-note)

Read me

What io.github.Coooolinz/why-note does

A zero-dependency, read-only Model Context Protocol server for searching and reading the notes in one WhyNote account.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'why-note-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

85/100across 5 weighted dimensions

How we score →

0255075100

−15

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked why-note-mcp against OSV.dev.

Inventory

Tools (9)

Click any tool to inspect its schema.

~258 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.Coooolinz/why-note safe to use?: io.github.Coooolinz/why-note has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install io.github.Coooolinz/why-note?: io.github.Coooolinz/why-note supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.Coooolinz/why-note do?: io.github.Coooolinz/why-note provides 9 tools: search, todos, read_day, recent_days, Install and 4 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.Coooolinz/why-note?: io.github.Coooolinz/why-note is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.Coooolinz/why-note actively maintained?: io.github.Coooolinz/why-note is actively maintained — last commit was 13 days ago.

Similar servers

Others in productivity

View all →

com.monday/monday.com94

MCP server for monday.com integration.

419 4

Superlocalmemory MCP Server94

Local-first AI memory with knowledge graphs and hybrid search. 17+ AI tools via MCP. Free.

219 6

Obsidian Sync MCP Server93

Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.

47 9

Mcp Sequentialthinking Tools92

🧠 An adaptation of the MCP Sequential Thinking Server to guide tool usage. This server provides recommendations for which MCP tools would be most effective at each stage.

584 1

MCP Security Weekly

Get CVE alerts and security updates for io.github.Coooolinz/why-note and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "note": { "env": { "NOTE_URL": "https://note.example.com", "NOTE_TOKEN": "<read-only-token>" }, "args": [ "-y", "why-note-mcp" ], "command": "npx" } } }

Install

Generate a read-only token in WhyNote settings, then configure your MCP client to run npx -y why-note-mcp with NOTE_URL and NOTE_TOKEN.

Generic project configuration:

{ "mcpServers": { "note": { "command": "npx", "args": ["-y", "why-note-mcp"], "env": { "NOTE_URL": "https://note.example.com", "NOTE_TOKEN": "<read-only-token>" } } } }

Claude Code:

claude mcp add --scope user note \ -e NOTE_URL=https://note.example.com \ -e NOTE_TOKEN='<read-only-token>' \ -- npx -y why-note-mcp

Codex CLI:

codex mcp add note \ --env NOTE_URL=https://note.example.com \ --env NOTE_TOKEN='<read-only-token>' \ -- npx -y why-note-mcp

Values written directly in a command may be retained in shell history. Edit the client configuration instead if that is a concern.

Node.js 18 or newer is required.

Security

The server reads NOTE_URL and NOTE_TOKEN only from its environment. It sends the token only as a Bearer credential to the configured WhyNote URL. It never receives the account password and exposes no write tool.

Changing the WhyNote account password revokes its read-only tokens. Generate a new token in WhyNote settings when a token expires or is revoked.

Frequently Asked Questions

Is io.github.Coooolinz/why-note safe to use?

io.github.Coooolinz/why-note has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install io.github.Coooolinz/why-note?

io.github.Coooolinz/why-note supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.Coooolinz/why-note do?

io.github.Coooolinz/why-note provides 9 tools: search, todos, read_day, recent_days, Install and 4 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.Coooolinz/why-note?

io.github.Coooolinz/why-note is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is io.github.Coooolinz/why-note actively maintained?

io.github.Coooolinz/why-note is actively maintained — last commit was 13 days ago.

WhyNote MCP

A zero-dependency, read-only Model Context Protocol server for searching and reading the notes in one WhyNote account.

Install

Generate a read-only token in WhyNote settings, then configure your MCP client to run npx -y why-note-mcp with NOTE_URL and NOTE_TOKEN.

Generic project configuration:

{
  "mcpServers": {
    "note": {
      "command": "npx",
      "args": ["-y", "why-note-mcp"],
      "env": {
        "NOTE_URL": "https://note.example.com",
        "NOTE_TOKEN": "<read-only-token>"
      }
    }
  }
}

Claude Code:

claude mcp add --scope user note \
  -e NOTE_URL=https://note.example.com \
  -e NOTE_TOKEN='<read-only-token>' \
  -- npx -y why-note-mcp

Codex CLI:

codex mcp add note \
  --env NOTE_URL=https://note.example.com \
  --env NOTE_TOKEN='<read-only-token>' \
  -- npx -y why-note-mcp

Values written directly in a command may be retained in shell history. Edit the client configuration instead if that is a concern.

Node.js 18 or newer is required.

Tools

search: search note lines by case-insensitive substring
todos: list incomplete or all todo items
read_day: read one date's complete note and etag
recent_days: read existing note days around an anchor date

Security

Changing the WhyNote account password revokes its read-only tokens. Generate a new token in WhyNote settings when a token expires or is revoked.

Development

npm ci
npm test
npm run pack:check

The test suite uses a local fake HTTP service; it does not require a WhyNote account, network access, or third-party dependencies.

License

MIT