upnote-mcp

upnote-mcp ist ein schreibgeschützter MCP-Server zum Lesen lokaler UpNote-Daten aus SQLite über stdio.

Dies ist ein inoffizielles Projekt und wird nicht von UpNote unterstützt, betrieben oder steht in Verbindung mit UpNote.

Funktionen

• search_notes: Notizen nach Titel, Text oder Zusammenfassung durchsuchen

• list_recent_notes: Die zuletzt aktualisierten Notizen auflisten

• list_notes_this_week: Notizen auflisten, die in der aktuellen Woche aktualisiert wurden

• list_notes_this_month: Notizen auflisten, die im aktuellen Monat aktualisiert wurden

• find_notes: Zeitraum-, Stichwort- und Tag-Filter in einem Aufruf kombinieren

• open_note: Eine Notiz in der UpNote-App per Notiz-ID öffnen

• get_note: Den vollständigen Inhalt einer Notiz per Notiz-ID abrufen

• open_notebook: Ein Notizbuch in der UpNote-App per Notizbuch-ID öffnen

• list_notebooks: Notizbücher mit Notizenanzahl auflisten

• create_note: Eine neue Notiz über das offizielle URL-Schema von UpNote erstellen

• list_tags: Tags auflisten

• search_by_tag: Notizen für einen Tag auflisten

Dieses Projekt ist bewusst schreibgeschützt. Es schreibt nicht in die UpNote-Datenbank. Sicheres Erstellen und Öffnen von Notizen erfolgt über das offizielle URL-Schema von UpNote anstelle von direkten Datenbankschreibvorgängen.

Related MCP server: upnote-lens-mcp

Paketname

Dieses Paket ist zur Veröffentlichung als @bellx2/upnote-mcp vorgesehen.

Voraussetzungen

• macOS

• bun auf dem Rechner installiert, der den Server ausführt

• UpNote-Desktop-App installiert

• Standard-UpNote-Datenbankpfad:

~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3

Wenn sich Ihre Datenbank woanders befindet, setzen Sie UPNOTE_DB.

Installieren

bun install

Ausführen

bun run start

Für den normalen Gebrauch bevorzugen Sie das veröffentlichte Paket:

bunx @bellx2/upnote-mcp

oder:

npx @bellx2/upnote-mcp

npx-Unterstützung setzt weiterhin voraus, dass bun installiert ist, da dieses Paket Bun-spezifische APIs wie bun:sqlite verwendet.

Für die Entwicklung mit Dateiüberwachung:

bun run dev

Umgebungsvariablen

• UPNOTE_DB: absoluter Pfad zu upnote.sqlite3

Beispiel:

export UPNOTE_DB="$HOME/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3"

Berechtigungen

Beim ersten Start kann Ihr MCP-Client Berechtigungsaufforderungen für die Befehlsausführung und den lokalen Dateizugriff anzeigen.

Dies ist zu erwarten, da der Server:

• über bun gestartet wird

• Ihre lokale UpNote-SQLite-Datenbank liest

• möglicherweise die UpNote-App für open_note, open_notebook oder create_note öffnet

Wenn Sie diese Berechtigungen verweigern, funktioniert die Notizsuche und -abfrage nicht. Nach Gewährung des Zugriffs müssen Sie möglicherweise den MCP-Server in Cursor oder Claude Desktop neu starten.

MCP-Konfigurationsbeispiel

Empfohlen: veröffentlichtes Paket

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "bunx",
      "args": ["@bellx2/upnote-mcp"]
    }
  }
}

Lokaler Entwicklungsklon

Cursor

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "upnote": {
      "command": "/absolute/path/to/bun",
      "args": ["run", "/absolute/path/to/upnote-mcp/src/index.ts"]
    }
  }
}

Beispiel-Workflows

Probieren Sie Aufforderungen wie:

• Suche in UpNote nach „Reise“ und zeige mir das erste Ergebnis

• Zeige mir meine 10 aktuellsten UpNote-Notizen

• Zeige mir die Notizen dieser Woche

• Zeige mir die Notizen dieses Monats

• Finde die KI-Notizen dieser Woche

• Finde die Notizen dieses Monats mit dem Tag „Besprechung“

• Liste meine UpNote-Tags auf und öffne die Notiz, die zum Tag „Besprechung“ passt

• Finde Notizen zum Thema „Start“, fasse sie zusammen und erstelle eine neue UpNote-Notiz mit der Zusammenfassung

• Liste Notizbücher auf und öffne das mit dem Namen „Forschung“

Werkzeugreferenz

search_notes

Eingabe:

{
  "query": "travel",
  "limit": 5
}

list_recent_notes

Eingabe:

{
  "limit": 10
}

list_notes_this_week

Eingabe:

{
  "limit": 20
}

list_notes_this_month

Eingabe:

{
  "limit": 20
}

find_notes

Eingabe:

{
  "period": "this_week",
  "query": "AI",
  "limit": 10
}

Oder:

{
  "period": "this_month",
  "tag": "meeting",
  "limit": 10
}

get_note

Eingabe:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_note

Eingabe:

{
  "id": "019fd239-a98a-742b-b75b-cee66e7aa830"
}

open_notebook

Eingabe:

{
  "id": "3f03c742-1270-4d35-a5bc-c7d98580d6fc"
}

list_notebooks

Eingabe:

{}

list_tags

Eingabe:

{}

search_by_tag

Eingabe:

{
  "tag": "meeting",
  "limit": 5
}

create_note

Eingabe:

{
  "title": "Meeting Notes",
  "text": "# Summary\n\nDraft created by MCP.",
  "markdown": true,
  "newWindow": false
}

Überprüfung

bun run check
bun run smoke

Japanische README

Die vorherige japanische README ist unter README_ja.md verfügbar.