quillink-mcp

Ein MCP-Server, der schreibgeschützten Zugriff auf Ihre Quillink-Notizen, Ordner und Tags für KI-Tools wie Claude Desktop, Claude Code und andere MCP-kompatible Clients bereitstellt.

Erfordert einen Pro-Quillink-Plan (API-Zugriff ist ein Pro-only-Feature).

Nicht auf PyPI veröffentlicht – lokal aus dem Quellcode erstellen und ausführen.

Erstellen

git clone https://github.com/dagistankaradeniz/gcp-note-taking-mcp.git
cd gcp-note-taking-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

Dies installiert den Befehl quillink-mcp in .venv/bin/. Beachten Sie den vollständigen Pfad zu dieser Binärdatei (z. B. /Users/you/gcp-note-taking-mcp/.venv/bin/quillink-mcp) – MCP-Clients starten sie direkt, nicht über eine aktivierte Shell, daher benötigen sie den absoluten Pfad.

Related MCP server: Bruin

Authentifizieren

Zwei Optionen:

Option A – OAuth-Geräteanmeldung (empfohlen für interaktive Nutzung):

.venv/bin/quillink-mcp login

Öffnet einen Gerätecode und eine Verifizierungs-URL; bestätigen Sie in Ihrem Browser. Das Token wird in Ihrem OS-Keyring gespeichert (oder als Fallback in ~/.config/quillink-mcp/credential).

Option B – Persönlicher Zugriffstoken:

Erstellen Sie einen in Quillink unter Einstellungen → Entwickler → Tokens (Berechtigungen: notes:read, folders:read, tags:read) und setzen Sie ihn dann als Umgebungsvariable:

export QUILLINK_TOKEN=qlk_pat_...

QUILLINK_TOKEN hat immer Vorrang vor einem gespeicherten OAuth-Login.

Verwendung mit Claude Desktop

Fügen Sie zu Ihrer Claude-Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json auf macOS):

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp"
    }
  }
}

Wenn Sie ein PAT anstelle von login verwenden, übergeben Sie es als Umgebungsvariable in der Konfiguration:

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp",
      "env": { "QUILLINK_TOKEN": "qlk_pat_..." }
    }
  }
}

Starten Sie Claude Desktop nach dem Bearbeiten der Konfiguration neu.

Verwendung mit anderen MCP-Clients

Jeder Client, der einen lokalen stdio-MCP-Server starten kann, funktioniert auf die gleiche Weise: Weisen Sie ihn auf den absoluten Pfad zu .venv/bin/quillink-mcp (mit gesetztem QUILLINK_TOKEN oder nachdem Sie einmal quillink-mcp login ausgeführt haben, sodass die Anmeldedaten bereits gespeichert sind). Dies umfasst Claude Code (claude mcp add quillink -- /absolute/path/to/.venv/bin/quillink-mcp) und jede OpenAI-kompatible Agentenlaufzeit, die den MCP-stdio-Transport unterstützt.

Werkzeuge

Alle schreibgeschützt – dieser Server kann nichts erstellen, bearbeiten oder löschen.

Vault-Notizen sind hier nie zugänglich – sie sind clientseitig Ende-zu-Ende verschlüsselt, sodass kein Server (einschließlich dieses) sie lesen kann. Organisationstools geben 404 für einen Aufrufer zurück, der nicht in einer Team-Plan-Organisation ist.

Konfiguration (Umgebungsvariablen)

Direkt ausführen (zum Testen)

.venv/bin/quillink-mcp login
.venv/bin/quillink-mcp   # runs the server on stdio -- an MCP client normally launches this for you