Repository navigation
Releases: zai-one/passbolt-mcp
Release list
Passbolt MCP 0.6.0
- Optional lazy tool loading (
PASSBOLT_TOOL_LOADING=eager|lazy, defaulteager= unchanged): lazy lists a small core pluspassbolt_enable_toolsets(toolsets with one-line description and token cost); enabling registers the tools at runtime and sendsnotifications/tools/list_changed. Allowlists, read-only mode and approval gates still apply. Setup wizard asks eager vs lazy. Startup tokens (tools/list + instructions, ≈chars/4): eager ≈2448, lazy ≈1048. Scope: enablement is per MCP session (FastMCP session visibility), so one client's enabled toolsets never appear for another. The HTTP transport here is stateless (every request is its own session), so enabled toolsets do not persist there: for shared HTTP useeagerorPASSBOLT_TOOLSETS. README lazy section lists verifiedtools/list_changedclient support with sources. passbolt_move_folder(PUT /move/folder) andpassbolt_unshare(share{id, delete:true}, owner permissions kept, resources simulated first) in the opt-inorganizetoolset, both approval-gated.- Shares now ask the user through MCP elicitation right before an approved share executes
(passbolt_share_resource, create resource/folder withshare_with_*); decline/cancel aborts and is
audited.PASSBOLT_SHARE_ELICITATION=auto|required|off(defaultauto: prompt only when the client supports elicitation). Operator approval still required. - Elicitation is shown only for a valid accepted approval that matches the exact request (operation +
arguments digest); otherwise no prompt and the write is refused as before. - Opt-in
organizetoolset:passbolt_move_resource(approval-gated move to a folder or root). - Opt-in
directorytoolset:passbolt_directory(group/user UUIDs the binding policy allows as share targets; per-resource permissions). PASSBOLT_TOOLSETSunset ordefaultkeeps the 0.5.0 surface;allnow also adds the opt-indirectoryandorganizetoolsets (write tools there still needPASSBOLT_WRITE_ENABLEDand operator approval).- Router generated from
ROUTESwith tool/skill/guide per line and playbook +guide/tool-mapfallback. - Router eval: 23 RU/EN requests (paraphrases, negative cases); fails on any unreachable tool, skill or guide.
- Security: resuming a create-with-share (resource or folder) whose share is still pending now asks the
share elicitation again under the currentPASSBOLT_SHARE_ELICITATIONmode, with or withoutapproval_id
(the first attempt consumed the approval); before, the resume executed the share without a prompt. Completed
results still replay without a prompt. - Security:
passbolt_unsharere-reads permissions right before the PUT and refuses (provider_precondition_failed,
nothing sent, key settled as failed) if a selected permission is gone, reassigned or became owner. Passbolt has
no conditional permission update, so a promotion in the short window after that re-read is still not caught. - Fix: the share elicitation form is a required boolean confirmation field instead of an empty form (deprecated
in FastMCP; hangs or renders blank in some clients, e.g. VS Code); consent needs accept with the box ticked.
Source: e9e94dc · Changes: v0.5.0...v0.6.0
Passbolt MCP 0.5.0
- License: LicenseRef-ZAI-ONE 2.0 (source-available). Free install and use for yourself and your organisation, including commercial work; issues and pull requests welcome; copying code into other projects, redistribution, embedding and competing hosted services need written permission. Earlier releases keep their LicenseRef-ZAI-ONE 1.0 terms (see NOTICE). README first screen: one-line scope, why this MCP, maintenance and update check.
- Agent layer: router
instructions(≤1200 chars: secrets never in chat, sink flow, operator approvals), compact template descriptions and titles; all descriptions ASCII. - Toolsets
meta,read,use,write(PASSBOLT_TOOLSETS,PASSBOLT_TOOLS,PASSBOLT_DISABLED_TOOLS,PASSBOLT_READ_ONLY=1= metadata reads only);passbolt://toolsets. - New read-only
passbolt_list_folders(GET /folders.json; id, name, parent, personal; v5 names decrypted in custody; folder policy enforced). - Resources
passbolt://playbook,passbolt://guide/{security,sinks,errors}; promptssecret_handoff,access_review. - Self-contained skills
passbolt-secret-handoff,passbolt-access-review,passbolt-onboard-client; Claude Code plugin manifest, Cursor rule,.agents/skills. scripts/token_budget.py+ tests gate instruction, description and SKILL.md sizes.- Model-facing text (router instructions,
passbolt://playbook, thepassbolt-onboard-clientskill) no longer names
the operator approval command: it says the operator accepts outside MCP and the agent never accepts it itself. The
command stays indocs/RUNTIME.mdfor operators. - Install snippets and the plugin manifest pin
zai-passbolt-mcp[standalone] @ git+https://github.com/zai-one/passbolt-mcp@v0.5.0.
Source: 8216320 · Changes: v0.4.0...v0.5.0
Passbolt MCP 0.4.0
- Safe readiness diagnostics: request-local, closed-vocabulary stage/reason logs without exception text or secret
material; metadata key trust, metadata decryption, secret fetch and secret decryption are reported separately without
relaxing any trust predicate. The three-booleanpassbolt_statuscontract is unchanged. - Passbolt 5.12 PIN code resources (
v5-pin-code) are listed by name and description instead of failing the whole
search. The PIN is never returned, andpassbolt_use_secretrefuses to deliver it. - Type-preserving
passbolt_update_resource: the type comes fromresource_type_idand is never converted.
v5-pin-codeentries accept onlynameanddescriptionand the PIN secret is not read, re-encrypted or sent;
other or unknown types (TOTP, custom fields, notes, v4) are refused before any write. v5-defaultupdates keep every uri, the icon and custom fields;urireplaces only the primary uri, and a password
rotation keeps the secret's description and custom fields inside server custody. Data outside the v5 schema is
refused before any encryption or write instead of being dropped.- A new
urion update follows the same domain policy as create and is checked before any approval, secret read,
decryption or write; new uris are limited to 1024 characters. Read mode accepts up to 32 uris per v5 resource. - Search and select results carry
resource_type(Passbolt slug orunknown). - MCP tool annotations (
readOnlyHint,destructiveHint,idempotentHint,openWorldHint) on every tool;
passbolt_selectisreadOnlyHint: falsebecause it authorises a laterpassbolt_use_secret. - Suggest-only update checker
passbolt_check_update: anonymous GitHub API, 3 s timeout, 24 h cache, plainvX.Y.Z
tags only, 30-minute back-off after a failure, never auto-updates or touches the vault. A cached hint appears in
server instructions andpassbolt_status; opt out withPASSBOLT_DISABLE_UPDATE_CHECK=1. - Tests: passwords, PINs, secure notes and encrypted payloads never appear in search, select or use results;
concurrent/cancelled probes, malformed key envelopes, real-GPG diagnostic refusal and approved encrypted password
updates with disposable keys. - Docs: embedded composition, registered authentication handlers, and updating a vault record versus rotating a
website password.
English setup · Описание по-русски
Download the wheel or source archive below and verify SHA256SUMS. The installed setup
command generates local JSON/TOML client configuration; a source checkout is optional.
Your own provider credentials and API permissions remain required.
Verified on Python 3.12, 3.13 and 3.14 on Linux and Windows: existing contracts,
synthetic functional tests, clean wheel installation and real MCP stdio checks.
Live provider accounts and production deployment were outside this release verification.
GitHub verification · Source commit b93031a6a22ad76e87345b55891b614b1cedb4b3.
ZAI.ONE is a digital agency for websites, SEO, advertising and analytics.
ZAI.ONE — интернет-агентство: сайты, SEO, реклама и аналитика.
Contact / Написать в Telegram about setup and integration.
LicenseRef-ZAI-ONE permits installation and internal use on your own or authorized
accounts; it is not an open-source license. Third-party rights remain unchanged.
Stars are welcome. Request changes through Issues.
Passbolt MCP 0.3.0
- Installable setup wizard and JSON/TOML client snippets that work outside the checkout.
- English and Russian agency information, integration contact and package installation guide.
- Local key/policy diagnostics via
passbolt_local_diagnosticsandpassbolt-mcp-doctor; signs a synthetic marker and checks the configured server public key without vault requests. - Built-in
https_probesecret handler: one fixed HTTPS GET with bearer or basic authentication, verified TLS, no redirects/proxy environment/retries, and no response data returned to MCP. - Real disposable-key selection/decryption/probe tests, target/scope/owner/replay checks and installed-wheel diagnostics.
English setup · Описание по-русски
Download the wheel or source archive below and verify SHA256SUMS. The installed setup
command generates local JSON/TOML client configuration; a source checkout is optional.
Your own provider credentials and API permissions remain required.
Verified on Python 3.12, 3.13 and 3.14 on Linux and Windows: existing contracts,
synthetic functional tests, clean wheel installation and real MCP stdio checks.
Live provider accounts and production deployment were outside this release verification.
GitHub verification · Source commit e6eeef1e70a4dcb60c61ed4dffa95ced004e9452.
ZAI.ONE is a digital agency for websites, SEO, advertising and analytics.
ZAI.ONE — интернет-агентство: сайты, SEO, реклама и аналитика.
Contact / Написать в Telegram about setup and integration.
LicenseRef-ZAI-ONE permits installation and internal use on your own or authorized
accounts; it is not an open-source license. Third-party rights remain unchanged.
Stars are welcome. Request changes through Issues.
Passbolt MCP 0.2.0
Install Passbolt MCP on your own computer or server and connect an MCP client.
- Quick start and installation guide.
- Changes in 0.2.0.
- Python 3.12, 3.13 and 3.14 verified on Linux and Windows. Clean wheel installation, real stdio discovery and source-distribution builds passed using synthetic fixtures.
- Provider credentials and API access remain required. Live provider validation is an operator step.
- Proprietary LicenseRef-ZAI-ONE: install and use for your own or authorized accounts. Separately identified third-party licenses remain unchanged. Stars welcome; request improvements through Issues.
Download the wheel or source archive below; verify it against SHA256SUMS.
Exact source commit: 1efb7cf07b959d2a7508cbb0517343c26f352541. Verification run.