quillink-mcp

Un servidor MCP que expone acceso de solo lectura a tus notas, carpetas y etiquetas de Quillink para herramientas de IA como Claude Desktop, Claude Code y otros clientes compatibles con MCP.

Requiere un plan Pro de Quillink (el acceso a la API es una función exclusiva de Pro).

No está publicado en PyPI -- compílalo y ejecútalo localmente desde el código fuente.

Compilación

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 .

Esto instala el comando quillink-mcp en .venv/bin/. Ten en cuenta la ruta completa a ese binario (p. ej. /Users/you/gcp-note-taking-mcp/.venv/bin/quillink-mcp) -- los clientes MCP lo lanzan directamente, no a través de un shell activado, por lo que necesitan la ruta absoluta.

Related MCP server: Bruin

Autenticación

Dos opciones:

Opción A — inicio de sesión de dispositivo OAuth (recomendado para uso interactivo):

.venv/bin/quillink-mcp login

Abre un código de dispositivo y una URL de verificación; apruébalo en tu navegador. El token se almacena en el llavero de tu sistema operativo (o en ~/.config/quillink-mcp/credential como alternativa).

Opción B — token de acceso personal:

Crea uno en Quillink en Configuración → Desarrollador → Tokens (ámbitos: notes:read, folders:read, tags:read) y luego establécelo como variable de entorno:

export QUILLINK_TOKEN=qlk_pat_...

QUILLINK_TOKEN siempre tiene prioridad sobre un inicio de sesión OAuth almacenado.

Uso con Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Si usas un PAT en lugar de login, pásalo como variable de entorno en la configuración:

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

Reinicia Claude Desktop después de editar la configuración.

Uso con otros clientes MCP

Cualquier cliente que pueda lanzar un servidor MCP stdio local funciona de la misma manera: apúntalo a la ruta absoluta de .venv/bin/quillink-mcp (con QUILLINK_TOKEN configurado, o después de ejecutar quillink-mcp login una vez para que la credencial ya esté almacenada). Esto incluye Claude Code (claude mcp add quillink -- /absolute/path/to/.venv/bin/quillink-mcp) y cualquier runtime de agente compatible con OpenAI que admita el transporte stdio de MCP.

Herramientas

Todo es de solo lectura: este servidor no puede crear, editar ni eliminar nada.

Las notas de Vault nunca son accesibles aquí: están cifradas de extremo a extremo en el cliente, por lo que ningún servidor (incluido este) puede leerlas. Las herramientas de organización devuelven 404 para un llamador que no esté en una organización del plan Team.

Configuración (variables de entorno)

Ejecutarlo directamente (para pruebas)

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