Для чего этот сервер?

Этот MCP-сервер даёт AI-агентам безопасный доступ к учётным записям из Vaultwarden или Bitwarden. Он избавляет от необходимости хранить пароли в коде или промптах. Агент получает их напрямую из хранилища через Bitwarden CLI. Сервер решает задачу безопасной автоматизации: браузерные агенты логинятся на реальные сайты, не раскрывая секреты и не перекладывая их в открытые файлы.

Что он умеет?

Сервер работает с Vaultwarden и Bitwarden: синхронизирует хранилище, ищет логины и читает пароли, TOTP-коды, заметки, историю паролей (секреты скрыты, пока не запрошен reveal=true), получает элементы, папки и коллекции по id. Создаёт логины, secure-заметки, SSH-ключи, карты и identity, обновляет поля и URI, переносит элементы в организацию. Управляет папками, коллекциями организаций и вложениями: создаёт, переименовывает, удаляет, восстанавливает из корзины, прикрепляет и скачивает файлы. Работает с Send: перечисляет, создаёт, редактирует, удаляет, получает. Генерирует пароли и username, кодирует Base64, проверяет статус и версию.

Каталог MCP
icoretech/warden-mcp

icoretech/warden-mcp

от icoretech

MCP-сервер для программного управления хранилищем Vaultwarden и Bitwarden через официальный CLI. Позволяет создавать, искать, читать и обновлять элементы, управлять вложениями и коллекциями. Идеаль...

Github NPM Сайт сервера

README

53 инструмента

Версии

Установить сервер

warden-mcp

Vaultwarden / Bitwarden MCP server for credential-aware AI agents.

license

warden-mcp lets MCP clients search, create, update, move, and read Vaultwarden or Bitwarden vault items through the official Bitwarden CLI (bw). It is built for agents and automation that need credentials, TOTP codes, secure notes, attachments, Sends, folders, organizations, and collections without re-implementing Bitwarden client-side crypto.

Use it when an agent needs to log in to real systems during a browser or admin workflow, but you do not want passwords hardcoded in prompts, config files, or one-off scripts.

Quick Start

Use stdio mode when a local MCP host launches the server directly. It is the simplest and most portable setup for desktop agents.

Prerequisites:

Node.js 22.x
npm 10.x
a Vaultwarden or Bitwarden account
either a Bitwarden API key pair or username/password login

Run the server:

BW_HOST=https://vaultwarden.example.com \
BW_CLIENTID=user.xxxxx \
BW_CLIENTSECRET=xxxxx \
BW_PASSWORD='your-master-password' \
npx -y @icoretech/warden-mcp@latest --stdio

Часто задаваемые вопросы

Инструменты были проиндексированы: 21.10.2026

keychain_create_attachment

Прикрепляет закодированные в base64 байты файла к существующему элементу. Возвращает обновлённую сводку элемента с обычными правилами редактирования, поэтому секреты остаются скрытыми, если только раскрытие не разрешено.

Создать вложение

Параметры

contentBase64stringобязательный
Байты файла в кодировке Base64, а не путь в файловой системе.
filenamestringобязательный
Видимое вложение или имя отправленного файла хранится в метаданных Bitwarden.
itemIdstringобязательный
Родительский идентификатор элемента Bitwarden для операций с вложениями или конкретными элементами.
revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.

keychain_create_card

Создаёт элемент платежной карты. Используйте это для имени держателя карты, бренда, номера, срока действия и кода, а не для учетных данных для входа или заметок. Принимает пользовательские поля, а также область действия папки/организации/коллекции, а возвращаемые сводки скрывают номер карты, код и скрытые поля.

Создать карточку

Параметры

brandstring
Бренд карты, такой как visa или mastercard.
cardholderNamestring
Имя держателя карты для сохранения на карте.
codestring
Код безопасности карты или CVV.
collectionIdsstring[]
Идентификаторы коллекций Bitwarden, а не идентификаторы папок.
expMonthstring
Месяц истечения срока действия карты.
expYearstring
Год истечения срока действия карты.
favoriteboolean
Отмечает элемент как избранный, когда значение истинно.
fieldsobject[]
Пользовательские поля для хранения на элементе. Скрытые поля редактируются в сводках.
folderIdstring
ID личной папки, а не ID коллекции организации.
namestringобязательный
Отображаемое имя для элемента платежной карты.
notesstring
Необязательный текст заметки, хранящийся на элементе.
numberstring
Основной номер карты для сохранения на карте.
organizationIdstring
Идентификатор организации Bitwarden; используется для операций с коллекциями на уровне организации.

keychain_create_folder

Создайте личную папку Bitwarden. Используйте это для организации элементов вне коллекций организации.

Создать папку

Параметры

namestringобязательный
Отображаемое имя для личной папки.

keychain_create_identity

Создаёт элемент идентификации. Используется для личных, контактных данных и адреса вместо логина или карты. Принимает структурированные поля идентификации, а также пользовательские поля и области видимости, а возвращаемые сводки скрывают конфиденциальные поля идентификации и скрытые пользовательские поля.

Создать личность

Параметры

collectionIdsstring[]
Идентификаторы коллекций Bitwarden, а не идентификаторы папок.
favoriteboolean
Отмечает элемент как избранный, когда значение истинно.
fieldsobject[]
Пользовательские поля для хранения на элементе. Скрытые поля редактируются в сводках.
folderIdstring
ID личной папки, а не ID коллекции организации.
identityobject
Структурированные данные профиля идентичности для хранения на элементе.
namestringобязательный
Отображаемое имя для элемента идентичности.
notesstring
Необязательный текст заметки, хранящийся на элементе.
organizationIdstring
Идентификатор организации Bitwarden; используется для операций с коллекциями на уровне организации.

keychain_create_login

Создайте элемент для входа с данными имя пользователя/пароль/TOTP/URI. Используйте его для учётных данных веб-сайта или приложения вместо защищённой заметки, карты или удостоверения личности. Принимает настраиваемые поля и вложения, поддерживает область действия папки/организации/коллекции и по умолчанию возвращает сокращённую сводку элемента.

Создать логин

Параметры

attachmentsobject[]
Вложения для добавления к элементу.
collectionIdsstring[]
Идентификаторы коллекций Bitwarden, а не идентификаторы папок.
favoriteboolean
Отмечает элемент как избранный, когда значение истинно.
fieldsobject[]
Пользовательские поля для хранения на элементе. Скрытые поля редактируются в сводках.
folderIdstring
ID личной папки, а не ID коллекции организации.
namestringобязательный
Отображаемое имя для элемента входа.
notesstring
Необязательные заметки в свободной форме для элемента входа.
organizationIdstring
Идентификатор организации Bitwarden; используется для операций с коллекциями на уровне организации.
passwordstring
Пароль для сохранения в элементе входа.
totpstring
Секрет TOTP или значение otpauth для элемента входа.
urisobject[]
Записи URI для сохранения или обновления в элементе входа.
usernamestring
Имя пользователя или адрес электронной почты для входа.

keychain_create_logins

Создаёт несколько элементов входа за один вызов. Используйте это, когда нужно сразу несколько независимых учётных данных, с тем же поведением элемента входа, что и в create_login. Установите continueOnError, чтобы продолжить после сбоя и получить результаты ok/error для каждого элемента; возвращаемые элементы по умолчанию скрыты.

Создать логины

Параметры

continueOnErrorboolean
Продолжать после ошибок и возвращать результаты ok/error для каждого элемента, когда установлено значение true.
itemsobject[]обязательный
Полезные данные для создания элементов входа; каждый элемент следует полям create_login и возвращает собственный результат ok или ошибку.

keychain_create_note

Создает защищенную заметку. Используйте для произвольного текста или секретов, которые не относятся к элементам входа, карты, удостоверения или ключа SSH. Принимает пользовательские поля и область папки/организации/коллекции, по умолчанию возвращает сокращенную сводку элемента.

Создать заметку

Параметры

collectionIdsstring[]
Идентификаторы коллекций Bitwarden, а не идентификаторы папок.
favoriteboolean
Отмечает элемент как избранный, когда значение истинно.
fieldsobject[]
Пользовательские поля для хранения на элементе. Скрытые поля редактируются в сводках.
folderIdstring
ID личной папки, а не ID коллекции организации.
namestringобязательный
Отображаемое имя для элемента защищенной заметки.
notesstring
Необязательный текст заметки, хранящийся на элементе.
organizationIdstring
Идентификатор организации Bitwarden; используется для операций с коллекциями на уровне организации.

keychain_create_org_collection

Создает новую коллекцию на уровне организации в указанном organizationId. Используется для группировки общих хранилищ; возвращает сводко созданной коллекции.

Create Org Collection

Параметры

namestringобязательный
Отображаемое имя для коллекции организации.
organizationIdstringобязательный
Идентификатор организации Bitwarden; необходим для операций с коллекциями в рамках организации.

keychain_create_ssh_key

Создаёт объект SSH-ключа, который хранится как защищённая заметка со стандартными полями. Используйте этот инструмент, когда нужна пара открытого и закрытого ключей и, опционально, отпечаток или комментарий — не для входа или платёжной карты. Закрытый ключ хранится в скрытом поле и скрывается в возвращаемых сводках; поддерживается область видимости папок, организаций и коллекций.

Создать SSH-ключ

Параметры

collectionIdsstring[]
Идентификаторы коллекций Bitwarden, а не идентификаторы папок.
commentstring
Необязательный комментарий или метка для SSH-ключа.
favoriteboolean
Отмечает элемент как избранный, когда значение истинно.
fingerprintstring
Необязательный отпечаток SSH-ключа.
folderIdstring
ID личной папки, а не ID коллекции организации.
namestringобязательный
Отображаемое имя SSH-ключа.
notesstring
Необязательный текст заметки, хранящийся на элементе.
organizationIdstring
Идентификатор организации Bitwarden; используется для операций с коллекциями на уровне организации.
privateKeystringобязательный
Материал закрытого ключа SSH для хранения на элементе.
publicKeystringобязательный
Материал открытого ключа SSH для хранения в элементе.

keychain_delete_attachment

Удаляет вложение из родительского элемента, используя itemId и attachmentId. Идентификатор вложения берется из метаданных вложения элемента — это действие разрушительно для вложения, после чего родительский элемент перезагружается. Возвращает обновленную сводку элемента с обычными правилами редактирования.

Удалить вложение

Параметры

attachmentIdstringобязательный
Идентификатор вложения, возвращаемый метаданными элемента, или однозначный селектор имени файла для загрузок.
itemIdstringобязательный
Родительский идентификатор элемента Bitwarden для операций с вложениями или конкретными элементами.
revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.

keychain_delete_folder

Удалить личную папку Bitwarden. Деструктивно: на этом сервере нет средства восстановления.

Удалить папку

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.

keychain_delete_item

Удаляет элемент хранилища по идентификатору. По умолчанию это мягкое удаление в корзину, элемент можно восстановить через restore_item. Установите permanent=true для полного удаления через bw. Возвращает только запрошенный id, не содержимое удаленного элемента.

Удалить элемент

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
permanentboolean
Если true — полное удаление сразу; если параметр опущен или false — мягкое удаление в корзину.

keychain_delete_items

Удаляет несколько элементов хранилища по идентификаторам в одном сеансе. По умолчанию выполняет мягкое удаление в корзину; установите permanent=true для полного удаления каждого идентификатора. Возвращает результат ok/error для каждого идентификатора, чтобы частичные ошибки были видны.

Удалить элементы

Параметры

idsstring[]обязательный
Идентификаторы элементов хранилища для удаления; возвращает один результат на каждый идентификатор.
permanentboolean
Выполняет жёсткое удаление каждого идентификатора немедленно, если указано значение true; при отсутствии значения или значении false выполняется мягкое удаление в корзину.

keychain_delete_org_collection

Удаление коллекции организации. Разрушительная операция: на этом сервере нет средства восстановления.

Удалить коллекцию организации

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
organizationIdstringобязательный
Идентификатор организации Bitwarden; необходим для операций с коллекциями в рамках организации.

keychain_edit_folder

Переименовать существующую личную папку Bitwarden по id. Это изменяет только метаданные папки, а не элементы внутри неё, и возвращает обновлённую сводку id/имени папки.

Edit Folder

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
namestringобязательный
Новое отображаемое имя для личной папки.

keychain_edit_org_collection

Переименовывает существующую коллекцию с областью видимости организации в указанном organizationId. Это изменяет только метаданные коллекции и возвращает обновлённую сводку коллекции.

Редактировать коллекцию организации

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
namestringобязательный
Новое отображаемое имя для коллекции организации.
organizationIdstringобязательный
Идентификатор организации Bitwarden; необходим для операций с коллекциями в рамках организации.

keychain_encodeтолько чтение

Кодирует строку в Base64 с помощью bw encode. Это никогда не изменяет хранилище; оно только возвращает закодированный текст.

Кодировать

Параметры

valuestringобязательный
Преобразует обычный текст в base64.

keychain_generateтолько чтение

Генерирует пароль или пассфразу с помощью bw generate. Эта команда никогда не изменяет хранилище; передайте reveal=true, чтобы вернуть значение, а NOREVEAL или KEYCHAIN_NOREVEAL принудительно скрывают вывод.

Сгенерировать

Параметры

ambiguousboolean
Разрешить неоднозначные символы в сгенерированных паролях.
capitalizeboolean
Преобразует слова парольной фразы в заглавные, когда это поддерживается bw.
includeNumberboolean
Включайте цифру в режиме парольной фразы, когда это поддерживается bw.
lengthinteger
Длина пароля в символах, от 5 до 256.
lowercaseboolean
Используйте строчные буквы при создании пароля.
minNumberinteger
Минимальное количество цифр.
minSpecialinteger
Минимальное количество специальных символов для включения.
numberboolean
Включайте числовые цифры при генерации пароля.
passphraseboolean
Сгенерируйте парольную фразу на основе слов вместо пароля.
revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.
separatorstring
Разделитель между словами в режиме парольной фразы.
specialboolean
Включайте специальные символы при генерации пароля.
uppercaseboolean
Включайте заглавные буквы при создании пароля.
wordsinteger
Количество слов в парольной фразе, от 3 до 50.

keychain_generate_usernameтолько чтение

Генерирует имя пользователя как генератор Bitwarden (случайное слово, email с плюс-адресацией, catch-all, перенаправленный псевдоним). Это никогда не изменяет хранилище; передайте reveal=true для возврата значения, а NOREVEAL или KEYCHAIN_NOREVEAL принудительно скрывают.

Сгенерировать имя пользователя

Параметры

capitalizeboolean
Ставьте заглавную букву в сгенерированном случайном слове, если это поддерживается.
domainstring
Домен для генерации имени пользователя для catch-all почты.
emailstring
Базовый email-адрес для генерации username с плюс-адресацией.
includeNumberboolean
Добавляйте номер к сгенерированным именам пользователей, если это поддерживается.
revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.
typeenum
Стратегия генерации имени пользователя: случайное слово, email с плюс-адресацией, перехватывающий email или пересылаемый псевдоним.

keychain_get_attachmentтолько чтение

Скачивает вложение из родительского элемента и возвращает сырые байты как contentBase64. Передай itemId и идентификатор вложения, или однозначный селектор имени файла, полученный из метаданных элемента, перед вызовом bw get attachment. Ответ содержит имя файла, количество байт и содержимое в base64 для локального декодирования. Если ожидаемое имя файла вложения отсутствует в метаданных keychain_get_item, запусти keychain_sync и keychain_get_item снова, после чего повтори попытку.

Получить вложение

Параметры

attachmentIdstringобязательный
Идентификатор вложения, возвращаемый метаданными элемента, или однозначный селектор имени файла для загрузок.
itemIdstringобязательный
Родительский идентификатор элемента Bitwarden для операций с вложениями или конкретными элементами.

keychain_get_collectionтолько чтение

Получить коллекцию по id (bw get collection). Используйте organizationId, когда нужно устранить неоднозначность поиска в рамках организации.

Получить коллекцию

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
organizationIdstring
Необязательный идентификатор организации уточняет поиск.

keychain_get_exposedтолько чтение

Проверяет количество скомпрометированных паролей, возвращаемое командой bw get exposed для указанного поискового запроса. Поисковые запросы следуют поведению bw lookup и могут быть неоднозначными; по возможности используйте точный идентификатор элемента или конкретный селектор. При отсутствии результатов возвращается скалярное значение null, а не выбрасывается ошибка not-found.

Получить Exposed

Параметры

termstringобязательный
Поисковый запрос или точный ID элемента; точные ID помогают избежать неоднозначных bw-поисков.

keychain_get_folderтолько чтение

Получить одну личную папку Bitwarden по стабильному идентификатору папки через bw get folder. Используйте это, чтобы проверить идентификатор папки перед обновлением элементов; возвращает только безопасные метаданные папки.

Получить папку

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.

keychain_get_itemтолько чтение

Возвращает полный элемент хранилища по стабильному id элемента. Секретные поля (включая заметки элемента и приватные ключи SSH) и подписанные URL вложений по умолчанию скрыты; передавайте reveal=true только когда вызывающему разрешено получать секреты, а NOREVEAL всё равно может принудительно скрыть их. Когда есть вложения, используйте keychain_get_attachment с этим id элемента и указанным id вложения или именем файла, чтобы скачать байты файла. Если ожидаемое недавно добавленное вложение отсутствует, запустите keychain_sync и вызовите keychain_get_item ещё раз, прежде чем повторять попытку.

Получить элемент

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.

keychain_get_notesтолько чтение

Получить заметки элемента, найденные по поисковому запросу с помощью bw get notes. Заметки считаются секретным выводом: значение равно null, если только reveal=true и NOREVEAL не активен. Термины могут быть неоднозначными, поэтому при возможности предпочитайте точный идентификатор элемента.

Получить заметки

Параметры

revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.
termstringобязательный
Поисковый запрос или точный ID элемента; точные ID помогают избежать неоднозначных bw-поисков.

keychain_get_organizationтолько чтение

Получить одну организацию Bitwarden по стабильному идентификатору организации через bw get organization. Сначала используй list_organizations, если id неизвестен; возвращает только метаданные организации.

Получить организацию

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.

keychain_get_org_collectionтолько чтение

Получить коллекцию организации по идентификатору (bw get org-collection). organizationId необязателен и при его указании сужает поиск в рамках организации.

Get Org Collection

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
organizationIdstring
Необязательный идентификатор организации, используемый для устранения неоднозначности при поиске в коллекции организации.

keychain_get_passwordтолько чтение

Получить пароль для входа по поисковому запросу (bw get password). Значение равно null, если только reveal=true, а NOREVEAL или KEYCHAIN_NOREVEAL могут по-прежнему принудительно скрывать его.

Получить пароль

Параметры

revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.
termstringобязательный
Поисковый запрос или точный идентификатор элемента, используемый для получения пароля через bw.

keychain_get_password_historyтолько чтение

Получить историю паролей элемента (если есть). Возврат паролей требует reveal=true.

Получить историю паролей

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.

keychain_get_totpтолько чтение

Получить текущий TOTP-код по поисковому запросу (bw get totp). Значение равно null, если только reveal не равен true, и NOREVEAL или KEYCHAIN_NOREVEAL могут по-прежнему принудительно скрывать его.

Получить TOTP

Параметры

revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.
termstringобязательный
Поисковый запрос или точный идентификатор элемента для bw get totp.

keychain_get_uriтолько чтение

Получает первый URI входа, найденный командой bw get uri по поисковому запросу. Запросы могут быть именами, идентификаторами или другими селекторами, поддерживаемыми bw, и могут быть неоднозначными, поэтому по возможности используйте точный идентификатор элемента. Значения URI возвращаются как несекретные скалярные результаты.

Получить URI

Параметры

termstringобязательный
Поисковый запрос или точный ID элемента; точные ID помогают избежать неоднозначных bw-поисков.

keychain_get_usernameтолько чтение

Получить имя пользователя для входа, найденное командой bw get username по поисковому запросу. Имена пользователей считаются несекретным скалярным выводом, но для неоднозначных имен безопаснее использовать точные идентификаторы элементов.

Получить имя пользователя

Параметры

termstringобязательный
Поисковый запрос или точный идентификатор элемента, используемый для bw get username.

keychain_list_collectionsтолько чтение

Перечисляет коллекции в текущем хранилище, опционально отфильтрованные по organizationId. Используйте list_org_collections, если вы уже знаете организацию и хотите получить только коллекции в её области видимости.

Список коллекций

Параметры

limitinteger
Максимум возвращаемых строк (1-500).
organizationIdstring
Необязательный фильтр по идентификатору организации для коллекций.
searchstring
Необязательный текстовый фильтр; пустое значение означает отсутствие фильтра.

keychain_list_foldersтолько чтение

Перечислить личные папки Bitwarden, видимые текущему пользователю. Используйте это, чтобы узнать идентификаторы папок для организации элементов; возвращает только безопасные сводки идентификаторов/названий папок.

List Folders

Параметры

limitinteger
Максимум возвращаемых строк (1-500).
searchstring
Необязательный текстовый фильтр; пустое значение означает отсутствие фильтра.

keychain_list_organizationsтолько чтение

Перечисляет организации, доступные текущему пользователю Bitwarden, чтобы вы могли узнать organizationId, необходимый для инструментов с областью действия организации.

List Organizations

Параметры

limitinteger
Максимум возвращаемых строк (1-500).
searchstring
Необязательный текстовый фильтр; пустое значение означает отсутствие фильтра.

keychain_list_org_collectionsтолько чтение

Выводит коллекции в рамках организации для указанного organizationId. Используйте это после обнаружения организации, чтобы найти идентификаторы коллекций; возвращает безопасные краткие сведения об идентификаторах и названиях.

Список коллекций организации

Параметры

limitinteger
Максимум возвращаемых строк (1-500).
organizationIdstringобязательный
Идентификатор организации Bitwarden; необходим для операций с коллекциями в рамках организации.
searchstring
Необязательный текстовый фильтр; пустое значение означает отсутствие фильтра.

keychain_move_item_to_organization

Перемещает существующий элемент хранилища в указанный organizationId. Опционально передайте collectionIds для назначения коллекций организации при перемещении - collectionIds относятся к коллекциям организации, а не к личным папкам. Возвращает сводку перемещенного элемента с обычными правилами редактирования.

Переместить элемент в организацию

Параметры

collectionIdsstring[]
Идентификаторы коллекций Bitwarden, а не идентификаторы папок.
idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
organizationIdstringобязательный
Идентификатор организации Bitwarden; необходим для операций с коллекциями в рамках организации.

keychain_receiveтолько чтениевнешний мир

Получает Bitwarden Send из HTTPS-ссылки. Укажите пароль, если Send защищён; obj=true возвращает разобранный JSON-объект, downloadFile=true загружает байты файла в base64, а по умолчанию возвращается полученный текст. Это считывает общий Send, не создаёт и не изменяет элементы хранилища.

Принять

Параметры

downloadFileboolean
Скачивает файл, отправляет и возвращает имя файла, байты и contentBase64.
objboolean
Верните полный разобранный объект JSON Send вместо сырого текста.
passwordstring
Требуется пароль для Send, если он был настроен.
urlstringобязательный
HTTPS Bitwarden Send URL для получения.

keychain_restore_item

Восстанавливает мягко удалённый элемент хранилища из корзины по идентификатору. Используйте это после delete_item или delete_items, когда параметр permanent был опущен или равен false; жёстко удалённые элементы восстановить нельзя. Возвращает сводку восстановленного элемента со стандартными правилами редактирования.

Восстановить элемент

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.

keychain_sdk_versionтолько чтение

Возвращает версию Bitwarden CLI, выводимую командой bw --version. Используйте эту проверку только для чтения при диагностике совместимости CLI и среды выполнения — она не затрагивает данные хранилища.

Версия CLI

Параметры

Без параметров.

keychain_search_itemsтолько чтение

Ищет элементы хранилища по тексту и фильтрам (org/folder/collection/url). Это обёртка над bw list items --search, которая не гарантирует поиск по значениям пользовательских полей.

Поиск элементов

Параметры

collectionIdstring
ID коллекции Bitwarden, а не ID папки.
folderIdstring
ID личной папки, а не ID коллекции организации.
limitinteger
Максимум возвращаемых строк (1-500).
organizationIdstring
Фильтр по идентификатору организации Bitwarden для поиска элементов в рамках организации.
textstring
Необязательный текстовый фильтр для названий элементов, имён пользователей, URI и других индексируемых полей. Значения пользовательских полей не всегда надёжно ищутся.
trashboolean
Искать элементы в корзине, когда true.
typeenum
Необязательный фильтр по типу элемента: login, note, ssh_key, card или identity.
urlstring
Необязательный фильтр по URL для поиска элементов.

keychain_send_createвнешний мир

Быстрое создание Bitwarden Send через bw send. Используйте type=text с текстом или type=file с именем файла и contentBase64; deleteInDays управляет удалением по истечении срока, maxAccessCount ограничивает число просмотров, password защищает Send паролем, а emails открывает доступ по электронной почте. Для продвинутых JSON-шаблонов или правок используйте send_create_encoded и send_edit.

Отправить Create

Параметры

contentBase64string
Файлы отправляются как байты в кодировке Base64, а не как путь в файловой системе.
deleteInDaysinteger
Количество дней до автоматического удаления Send в Bitwarden (1–3650).
emailsstring[]
Адреса электронной почты получателей для доступа Bitwarden Send, ограниченного электронной почтой. Взаимоисключающе с паролем; вызывающим всё равно нужно поделиться URL-адресом Send.
filenamestring
Для отправки файлов требуется указать имя файла и содержимое в формате contentBase64.
fullObjectboolean
Просит bw send вернуть полный объект Send, когда это поддерживается.
hiddenboolean
Скрыть текст: отправлять содержимое по умолчанию, когда получатели открывают его.
maxAccessCountinteger
Максимальное количество обращений к Send до того, как он станет недоступным.
namestring
Необязательно. Отправляет отображаемое имя.
notesstring
Необязательные личные заметки к отправке.
passwordstring
Необязательный пароль доступа для отправки, требуемый получателями.
textstring
Отправляет текстовое содержимое для type=text.
typeenumобязательный
Отправьте тип полезной нагрузки: текст использует текст; файл использует имя файла плюс contentBase64.

keychain_send_create_encodedвнешний мир

Создаёт Send с помощью расширенного потока bw send create. Принимает шаблон encodedJson или необработанный json для кодирования, либо создаёт напрямую из полей text/file; file использует filename и contentBase64, а параметр hidden влияет только на текстовые Send. Используйте это, когда нужны поля на уровне шаблона, выходящие за рамки опций quick send_create.

Отправить создание (закодированный JSON)

Параметры

encodedJsonstring
Base64-кодированный JSON-шаблон Send, передаваемый в bw send create.
fileobject
Альтернативная передача файла напрямую с помощью имени файла и contentBase64.
hiddenboolean
Отправляет содержимое по умолчанию, когда значение равно true.
jsonany
Отправляет сырой JSON-шаблон; сервер кодирует его перед bw send create.
textstring
Прямая текстовая полезная нагрузка как альтернатива encodedJson/json.

keychain_send_deleteвнешний мир

Удаляет Bitwarden Send по ID с помощью команды bw send delete. Это разрушительно для самого Send и его общего содержимого; при этом не удаляются никакие элементы хранилища, которые могли быть использованы для его создания. Видимый текст содержит запрошенный ID Send, а структурированный вывод включает как этот ID, так и полезную нагрузку результата bw, когда она доступна.

Отправить удаление

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.

keychain_send_editвнешний мир

Редактирует существующий Send с помощью расширенного потока bw send edit. Нужно передать encodedJson или raw json, содержащие данные для редактирования Send; raw json кодируется перед вызовом bw. Необязательный itemId соответствует --itemid для редактирования Send, привязанных к элементам.

Send Edit (закодированный JSON)

Параметры

encodedJsonstring
Полезная нагрузка JSON в кодировке Base64 для редактирования Send, передаваемая в bw send edit.
itemIdstring
Необязательный идентификатор родительского элемента, передаваемый в bw send edit как --itemid.
jsonany
Отправьте сырой JSON-полезный груз; сервер кодирует его перед выполнением bw send edit.

keychain_send_getтолько чтениевнешний мир

Получить Sends, принадлежащие вам. Используйте text=true, чтобы получить текстовое содержимое; файловые Sends возвращают метаданные, включая accessUrl. Чтобы скачать байты файлового Send, вызовите receive с этим accessUrl и downloadFile=true.

Отправить GET

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
textboolean
Возвращайте текстовое содержимое Send вместо JSON-метаданных.

keychain_send_listтолько чтениевнешний мир

Вывести список всех Send, принадлежащих вам (bw send list). Это доступно только для чтения и не изменяет хранилище.

Отправить список

Параметры

Без параметров.

keychain_send_remove_passwordвнешний мир

Удаляет сохранённый пароль Send, чтобы получателям больше не нужен был этот пароль. Это разрушительно только для пароля Send; оно не удаляет содержимое Send. Используйте send_delete, когда нужно удалить весь Send.

Отправить запрос на удаление пароля

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.

keychain_send_templateтолько чтениевнешний мир

Получает шаблон Bitwarden Send JSON из bw send template. Выберите текстовый или файловый шаблон с объектными значениями send.text/text или send.file/file перед использованием закодированных потоков create/edit. Это только для чтения и не создаёт Send.

Отправить шаблон

Параметры

objectenumобязательный
Объект шаблона для получения: text/send.text для текстовых отправок или file/send.file для файловых отправок.

keychain_set_login_uris

Устанавливает или обновляет список URI для элемента входа. mode=replace полностью заменяет список; mode=merge обновляет существующие URI и добавляет новые по URI. Допустимые значения match: domain, host, startsWith, exact, regex или never.

Установить URI входа

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
modeenum
Поведение слияния URI: замена полностью перезаписывает список; слияние обновляет существующие URI и добавляет новые по URI.
revealboolean
Определяет, возвращаются ли секретные значения; по умолчанию false, может быть принудительно установлено в false с помощью NOREVEAL.
urisobject[]обязательный
Записи URI для сохранения или обновления в элементе входа.

keychain_statusтолько чтение

Возвращает статус Bitwarden CLI (заблокирован/разблокирован, сервер, пользователь). Это отложенная проверка: статус «не готов» не означает, что последующие вызовы keychain tool не смогут разблокировать или восстановить доступ по запросу.

Vault Status

Параметры

Без параметров.

keychain_syncтолько чтение

Загружает последние данные хранилища с сервера (bw sync). Возвращает метку времени последней синхронизации.

Sync Vault

Параметры

Без параметров.

keychain_update_item

Обновляет выбранные поля элемента по идентификатору. Патч применяется к текущему элементу: пропущенные поля остаются без изменений, а явные null и пустые массивы перезаписывают сохранённые значения папки, коллекции, URI входа или пользовательских полей. Используйте для частичных правок вместо полной пересборки элемента.

Обновить элемент

Параметры

idstringобязательный
Стабильный идентификатор объекта Bitwarden, возвращаемый инструментами list/search/get/create.
patchobjectобязательный

`0.2.54`основная	18.10.2026
`0.2.53`	13.10.2026
`0.2.52`	12.10.2026
`0.2.51`	09.10.2026
`0.2.50`	06.10.2026
`0.2.49`	06.10.2026
`0.2.48`	03.10.2026
`0.2.47`	02.10.2026
`0.2.46`	01.10.2026
`0.2.45`	29.09.2026
`0.2.44`	25.09.2026
`0.2.43`	25.09.2026
`0.2.42`	17.09.2026
`0.2.41`	14.09.2026
`0.2.40`	14.09.2026
`0.2.39`	13.09.2026
`0.2.38`	11.09.2026
`0.2.37`	10.09.2026
`0.2.36`	02.09.2026
`0.2.35`	30.08.2026
`0.2.34`	29.08.2026
`0.2.33`	29.08.2026
`0.2.32`	29.08.2026
`0.2.31`	16.08.2026
`0.2.30`	30.07.2026
`0.2.29`	07.07.2026
`0.2.28`	23.06.2026
`0.2.27`	22.06.2026
`0.2.26`	16.06.2026
`0.2.25`	16.06.2026
`0.2.24`	16.06.2026
`0.2.23`	09.06.2026
`0.2.22`	01.06.2026
`0.2.21`	31.05.2026
`0.2.20`	06.05.2026
`0.2.19`	04.05.2026
`0.2.18`	29.04.2026
`0.2.17`	28.04.2026
`0.2.16`	28.04.2026
`0.2.15`	26.04.2026
`0.2.14`	26.04.2026
`0.2.13`	22.04.2026
`0.2.12`	22.04.2026
`0.2.11`	22.04.2026
`0.2.10`	22.04.2026
`0.2.9`	22.04.2026
`0.2.8`	07.04.2026
`0.2.7`	06.04.2026
`0.2.6`	06.04.2026
`0.2.5`	05.04.2026
`0.2.4`	27.03.2026
`0.2.3`	25.03.2026
`0.2.2`	23.03.2026
`0.2.1`	23.03.2026
`0.2.0`	23.03.2026
`0.1.21`	22.03.2026
`0.1.20`	22.03.2026
`0.1.19`	22.03.2026
`0.1.18`	22.03.2026
`0.1.17`	22.03.2026
`0.1.16`	22.03.2026
`0.1.15`	22.03.2026
`0.1.14`	22.03.2026
`0.1.13`	22.03.2026
`0.1.12`	22.03.2026
`0.1.10`	22.03.2026
`0.1.9`	21.03.2026
`0.1.8`	21.03.2026
`0.1.7`	21.03.2026
`0.1.6`	21.03.2026
`0.1.5`	21.03.2026
`0.1.4`	21.03.2026
`0.1.3`	21.03.2026
`0.1.2`	21.03.2026
`0.1.1`	21.03.2026
`0.1.0`	21.03.2026

Выберите клиент, чтобы установить icoretech/warden-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "icoretech-warden-mcp-jjpjhq4j6g": {
      "command": "npx",
      "args": [
        "-y",
        "@icoretech/warden-mcp@latest",
        "--stdio"
      ],
      "env": {
        "BW_HOST": "https://vaultwarden.example.com",
        "BW_CLIENTID": "user.xxxxx",
        "BW_CLIENTSECRET": "xxxxx",
        "BW_PASSWORD": "your-master-password"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "icoretech-warden-mcp-jjpjhq4j6g": {
      "command": "npx",
      "args": [
        "-y",
        "@icoretech/warden-mcp@latest",
        "--stdio"
      ],
      "env": {
        "BW_HOST": "https://vaultwarden.example.com",
        "BW_CLIENTID": "user.xxxxx",
        "BW_CLIENTSECRET": "xxxxx",
        "BW_PASSWORD": "your-master-password"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "icoretech-warden-mcp-jjpjhq4j6g": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@icoretech/warden-mcp@latest",
        "--stdio"
      ],
      "env": {
        "BW_HOST": "https://vaultwarden.example.com",
        "BW_CLIENTID": "user.xxxxx",
        "BW_CLIENTSECRET": "xxxxx",
        "BW_PASSWORD": "your-master-password"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"icoretech-warden-mcp-jjpjhq4j6g\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@icoretech/warden-mcp@latest\",\"--stdio\"],\"env\":{\"BW_HOST\":\"https://vaultwarden.example.com\",\"BW_CLIENTID\":\"user.xxxxx\",\"BW_CLIENTSECRET\":\"xxxxx\",\"BW_PASSWORD\":\"your-master-password\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "icoretech-warden-mcp-jjpjhq4j6g": {
      "command": "npx",
      "args": [
        "-y",
        "@icoretech/warden-mcp@latest",
        "--stdio"
      ],
      "env": {
        "BW_HOST": "https://vaultwarden.example.com",
        "BW_CLIENTID": "user.xxxxx",
        "BW_CLIENTSECRET": "xxxxx",
        "BW_PASSWORD": "your-master-password"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add icoretech-warden-mcp-jjpjhq4j6g --env BW_HOST=https://vaultwarden.example.com --env BW_CLIENTID=user.xxxxx --env BW_CLIENTSECRET=xxxxx --env BW_PASSWORD=your-master-password -- npx -y @icoretech/warden-mcp@latest --stdio

Либо через JSON-конфиг:

claude mcp add-json icoretech-warden-mcp-jjpjhq4j6g "{\"command\":\"npx\",\"args\":[\"-y\",\"@icoretech/warden-mcp@latest\",\"--stdio\"],\"env\":{\"BW_HOST\":\"https://vaultwarden.example.com\",\"BW_CLIENTID\":\"user.xxxxx\",\"BW_CLIENTSECRET\":\"xxxxx\",\"BW_PASSWORD\":\"your-master-password\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add icoretech-warden-mcp-jjpjhq4j6g --env BW_HOST=https://vaultwarden.example.com --env BW_CLIENTID=user.xxxxx --env BW_CLIENTSECRET=xxxxx --env BW_PASSWORD=your-master-password -- npx -y @icoretech/warden-mcp@latest --stdio

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.icoretech-warden-mcp-jjpjhq4j6g]
command = "npx"
args = ["-y", "@icoretech/warden-mcp@latest", "--stdio"]

[mcp_servers.icoretech-warden-mcp-jjpjhq4j6g.env]
BW_HOST = "https://vaultwarden.example.com"
BW_CLIENTID = "user.xxxxx"
BW_CLIENTSECRET = "xxxxx"
BW_PASSWORD = "your-master-password"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите icoretech/warden-mcp, а в поле команды запуска — строку ниже:

npx -y @icoretech/warden-mcp@latest --stdio

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "icoretech-warden-mcp-jjpjhq4j6g": {
      "command": "npx",
      "args": [
        "-y",
        "@icoretech/warden-mcp@latest",
        "--stdio"
      ],
      "env": {
        "BW_HOST": "https://vaultwarden.example.com",
        "BW_CLIENTID": "user.xxxxx",
        "BW_CLIENTSECRET": "xxxxx",
        "BW_PASSWORD": "your-master-password"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "icoretech-warden-mcp-jjpjhq4j6g": {
      "command": "npx",
      "args": [
        "-y",
        "@icoretech/warden-mcp@latest",
        "--stdio"
      ],
      "env": {
        "BW_HOST": "https://vaultwarden.example.com",
        "BW_CLIENTID": "user.xxxxx",
        "BW_CLIENTSECRET": "xxxxx",
        "BW_PASSWORD": "your-master-password"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например icoretech-warden-mcp-jjpjhq4j6g.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: icoretech-warden-mcp-jjpjhq4j6g
    command: npx
    args:
      - "-y"
      - "@icoretech/warden-mcp@latest"
      - "--stdio"
    env:
      BW_HOST: https://vaultwarden.example.com
      BW_CLIENTID: user.xxxxx
      BW_CLIENTSECRET: xxxxx
      BW_PASSWORD: your-master-password

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "icoretech-warden-mcp-jjpjhq4j6g": {
      "command": "npx",
      "args": [
        "-y",
        "@icoretech/warden-mcp@latest",
        "--stdio"
      ],
      "env": {
        "BW_HOST": "https://vaultwarden.example.com",
        "BW_CLIENTID": "user.xxxxx",
        "BW_CLIENTSECRET": "xxxxx",
        "BW_PASSWORD": "your-master-password"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@icoretech/warden-mcp@latest",
    "--stdio"
  ],
  "env": {
    "BW_HOST": "https://vaultwarden.example.com",
    "BW_CLIENTID": "user.xxxxx",
    "BW_CLIENTSECRET": "xxxxx",
    "BW_PASSWORD": "your-master-password"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx