Align tool schema docs with supported item_get and note_create behavior#11
Merged
Merged
Conversation
Retrieve a full 1Password item (title, category, tags, notes, and all fields with id/title/type/section) via vault+item ID or a secret reference. Concealed field values are hidden behind a placeholder unless the caller passes reveal=true, mirroring password_read's conceal pattern. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Edit an existing item after creation: title, notes (empty string clears notes — the create/edit/delete-notes capability), tags, website URL, and field upserts/removals. The item is fetched, changes are applied immutably, and written back via items.put; unreferenced fields are left untouched and field values are never logged. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
List every item in a vault, returning id, title, category, tags, and updatedAt for each. Returns metadata only — no secret values are read or emitted. Also documents item_get/item_edit/item_list in the README tools table. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Create a Secure Note item (ItemCategory.SecureNote) with a title, note body, optional tags, and optional custom text/concealed fields. Mirrors password_create conventions (items.create, errorResult, log/logError) and never logs field values. Closes #8. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Archive an item via the SDK's items.archive(vaultId, itemId), moving it to the archive instead of permanently deleting it. Guards with a capability check (like item_delete) so older SDKs return a clean errorResult. Closes #9. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copilot
AI
changed the title
[WIP] Fix code based on feedback in review comments
Align tool schema docs with supported item_get and note_create behavior
Jul 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This tightens the new tool documentation surfaced through MCP so it matches the behavior introduced in the PR. It corrects the secret reference format documented by
item_getand clarifies the custom field wording innote_create.Schema/docs alignment
item_gettool description to document secret references asop://vault/item/fielditem_get.secretReferenceparameter docs to the sameop://vault/item/fieldformatnote_create.fields[].idOrTitleas a single identifier:id or titleRegression coverage
item_getsecret reference formatnote_createcustom field wording