quillink-mcp

Сервер MCP, предоставляющий доступ только для чтения к вашим заметкам, папкам и тегам Quillink для ИИ-инструментов, таких как Claude Desktop, Claude Code и других MCP-совместимых клиентов.

Требуется Pro-план Quillink (доступ к API — функция только для Pro).

Не опубликовано на PyPI — соберите и запустите его локально из исходного кода.

Сборка

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 .

Эта команда устанавливает команду quillink-mcp в .venv/bin/. Обратите внимание на полный путь к этому бинарному файлу (например, /Users/you/gcp-note-taking-mcp/.venv/bin/quillink-mcp) -- MCP-клиенты запускают его напрямую, а не через активированную оболочку, поэтому им нужен абсолютный путь.

Related MCP server: Bruin

Аутентификация

Два варианта:

Вариант A — вход через OAuth-устройство (рекомендуется для интерактивного использования):

.venv/bin/quillink-mcp login

Открывает код устройства и URL для проверки; подтвердите его в браузере. Токен сохраняется в связке ключей ОС (или в ~/.config/quillink-mcp/credential как запасной вариант).

Вариант B — персональный токен доступа:

Создайте его в Quillink в разделе Настройки → Разработчик → Токены (области: notes:read, folders:read, tags:read), затем задайте его как переменную окружения:

export QUILLINK_TOKEN=qlk_pat_...

QUILLINK_TOKEN всегда имеет приоритет над сохранённым OAuth-входом.

Использование с Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

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

Если вы используете PAT вместо login, передайте его как переменную окружения в конфигурации:

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

Перезапустите Claude Desktop после редактирования конфигурации.

Использование с другими MCP-клиентами

Любой клиент, который может запустить локальный MCP-сервер stdio, работает так же: укажите ему абсолютный путь к .venv/bin/quillink-mcp (с установленным QUILLINK_TOKEN или после однократного запуска quillink-mcp login, чтобы учётные данные уже были сохранены). Это включает Claude Code (claude mcp add quillink -- /absolute/path/to/.venv/bin/quillink-mcp) и любую среду выполнения агентов, совместимую с OpenAI, которая поддерживает транспорт MCP stdio.

Инструменты

Все инструменты доступны только для чтения — этот сервер не может создавать, редактировать или удалять что-либо.

Заметки Vault здесь никогда не доступны — они зашифрованы сквозным шифрованием на стороне клиента, поэтому ни один сервер (включая этот) не может их прочитать. Инструменты организации возвращают 404 для вызывающего, который не состоит в организации с Team-планом.

Конфигурация (переменные окружения)

Запуск напрямую (для тестирования)

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