English Français العربية

WhyNote

Registre officiel Recherche et web

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

Code source Site web Documentation

Que pouvez-vous faire avec 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • NOTE_URL obligatoire Base URL of the WhyNote service
  • NOTE_TOKEN obligatoire secret Read-only token generated in WhyNote settings

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que WhyNote ?

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

Comment installer WhyNote ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour WhyNote ?

Oui. Il attend NOTE_URL, NOTE_TOKEN, à renseigner dans sa configuration.

WhyNote est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient WhyNote ?

Il est publié par Coooolinz. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.