English Français العربية

WhyNote

السجل الرسمي البحث والويب

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

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع WhyNote؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package why-note-mcp
Claude Code 
claude mcp add whynote -e 'NOTE_URL=<NOTE_URL>' -e 'NOTE_TOKEN=<your note_token>' -- npx -y why-note-mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "whynote": {
            "command": "npx",
            "args": [
                "-y",
                "why-note-mcp@0.1.0"
            ],
            "env": {
                "NOTE_URL": "<NOTE_URL>",
                "NOTE_TOKEN": "<your note_token>"
            }
        }
    }
}

متغيرات البيئة

  • NOTE_URL إلزامي Base URL of the WhyNote service
  • NOTE_TOKEN إلزامي سري Read-only token generated in WhyNote settings

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. WhyNote MCP
  2. Install
  3. Tools
  4. Security
  5. Development
  6. License

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

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.

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

الأسئلة الشائعة

ما هو WhyNote؟

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

كيف أثبّت WhyNote؟

يعمل على جهازك. في Claude Code: claude mcp add whynote -e 'NOTE_URL=<NOTE_URL>' -e 'NOTE_TOKEN=<your note_token>' -- npx -y why-note-mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج WhyNote إلى مفتاح API؟

نعم. يتطلب NOTE_URL, NOTE_TOKEN، وتضبطها في إعداداته.

هل WhyNote مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون WhyNote؟

ينشره Coooolinz. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.