@commandable/integration-data 0.0.5 → 0.0.7

package/integrations/github/prompt.md

@@ -0,0 +1,36 @@
+# GitHub coding workflow
+
+## Branch-based workflow
+
+Always work on a feature branch, never commit directly to main:
+
+1. `create_branch` from the default branch
+2. Make changes with `edit_file`, `edit_files`, `create_file`, or `delete_file` -- each call auto-commits to the branch
+3. `create_pull_request` when done
+4. `merge_pull_request` with `merge_method: "squash"` to collapse all commits into one clean commit on main
+
+Multiple small commits on a feature branch are fine -- they get squash-merged into a single commit.
+
+## Choosing the right write tool
+
+- **`edit_file`** -- Surgical edits to a single existing file. Use for most code changes. Each call is a commit.
+- **`edit_files`** -- Atomic multi-file changes (create + edit + delete in one commit). Use when files must change together to stay consistent (e.g. renaming across files, adding a module + updating imports).
+- **`create_file`** -- Create a new file or completely replace an existing file's content. Use for new files or full rewrites.
+- **`delete_file`** -- Remove a file.
+
+## Search/replace rules for edit_file and edit_files
+
+The `old_text` field must be an **exact match** of the text currently in the file:
+
+- Whitespace matters: spaces, tabs, and indentation must match exactly
+- Line breaks matter: include the exact newline characters
+- Include enough surrounding context to uniquely identify the location
+- Each edit replaces the **first occurrence** only. To replace multiple occurrences, use separate edits.
+
+**Before editing**, call `get_file_contents` to see the file's current content. This avoids failed edits from stale or incorrect assumptions about file content.
+
+## Reading before writing
+
+- Use `get_repo_tree` to discover the project structure and file paths
+- Use `get_file_contents` to read a file before editing it
+- Use `search_code` to find where something is defined or used across the repo

package/integrations/github/schemas/create_file.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch to commit to" },
+    "path": { "type": "string", "description": "File path to create (e.g. 'src/utils/helpers.ts')" },
+    "content": { "type": "string", "description": "Plain text file content" },
+    "message": { "type": "string", "description": "Commit message" }
+  },
+  "required": ["owner", "repo", "branch", "path", "content", "message"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_pull_request_review.json

@@ -0,0 +1,17 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" },
+    "event": {
+      "type": "string",
+      "enum": ["APPROVE", "REQUEST_CHANGES", "COMMENT"],
+      "description": "Review action: APPROVE to approve, REQUEST_CHANGES to request changes, COMMENT to leave a comment only"
+    },
+    "body": { "type": "string", "description": "Review summary comment (required when event is REQUEST_CHANGES or COMMENT)" },
+    "commit_id": { "type": "string", "description": "SHA of the commit to review. Defaults to the latest commit on the PR." }
+  },
+  "required": ["owner", "repo", "pull_number", "event"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/create_release.json

@@ -0,0 +1,16 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "tag_name": { "type": "string", "description": "Tag to create the release from (e.g. 'v1.2.0'). The tag must already exist or target_commitish must be provided." },
+    "name": { "type": "string", "description": "Release title (defaults to tag_name)" },
+    "body": { "type": "string", "description": "Release notes in markdown" },
+    "draft": { "type": "boolean", "description": "Create as an unpublished draft release", "default": false },
+    "prerelease": { "type": "boolean", "description": "Mark as a pre-release (alpha, beta, rc, etc.)", "default": false },
+    "target_commitish": { "type": "string", "description": "Branch name or commit SHA to tag from (defaults to the repo's default branch). Required if the tag does not yet exist." },
+    "generate_release_notes": { "type": "boolean", "description": "Auto-generate release notes from commits merged since the previous release", "default": false }
+  },
+  "required": ["owner", "repo", "tag_name"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/delete_branch.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch name to delete (e.g. 'feature/my-feature')" }
+  },
+  "required": ["owner", "repo", "branch"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/delete_file.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "path": { "type": "string", "description": "Path of the file to delete (e.g. 'src/old-file.js')" },
+    "message": { "type": "string", "description": "Commit message" },
+    "sha": { "type": "string", "description": "Optional blob SHA. If omitted, the SHA is fetched automatically." },
+    "branch": { "type": "string", "description": "Branch to delete the file from (defaults to the repo's default branch)" }
+  },
+  "required": ["owner", "repo", "path", "message"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/edit_file.json

@@ -0,0 +1,26 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch to commit to" },
+    "path": { "type": "string", "description": "Path of the file to edit (e.g. 'src/index.ts')" },
+    "edits": {
+      "type": "array",
+      "description": "Search/replace operations applied in order. Each old_text must match the file content exactly, including whitespace and indentation.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "old_text": { "type": "string", "description": "Exact text to find in the file" },
+          "new_text": { "type": "string", "description": "Text to replace it with" }
+        },
+        "required": ["old_text", "new_text"],
+        "additionalProperties": false
+      },
+      "minItems": 1
+    },
+    "message": { "type": "string", "description": "Commit message" }
+  },
+  "required": ["owner", "repo", "branch", "path", "edits", "message"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/edit_files.json

@@ -0,0 +1,39 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Branch to commit to" },
+    "message": { "type": "string", "description": "Commit message" },
+    "files": {
+      "type": "array",
+      "description": "Files to create, edit, or delete in this commit",
+      "items": {
+        "type": "object",
+        "properties": {
+          "path": { "type": "string", "description": "File path in the repository" },
+          "action": { "type": "string", "enum": ["create", "edit", "delete"], "description": "'create': new file or overwrite with content. 'edit': apply search/replace edits to existing file. 'delete': remove the file." },
+          "content": { "type": "string", "description": "Full file content (required for 'create' action)" },
+          "edits": {
+            "type": "array",
+            "description": "Search/replace pairs (required for 'edit' action). Each old_text must match exactly, including whitespace.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "old_text": { "type": "string", "description": "Exact text to find" },
+                "new_text": { "type": "string", "description": "Text to replace it with" }
+              },
+              "required": ["old_text", "new_text"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["path", "action"],
+        "additionalProperties": false
+      },
+      "minItems": 1
+    }
+  },
+  "required": ["owner", "repo", "branch", "message", "files"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/fork_repo.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner to fork from" },
+    "repo": { "type": "string", "description": "Repository name to fork" },
+    "organization": { "type": "string", "description": "Organization to fork into (defaults to the authenticated user's account)" },
+    "name": { "type": "string", "description": "New name for the forked repository (defaults to the original name)" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_commit.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "sha": { "type": "string", "description": "Commit SHA, branch name, or tag name" },
+    "page": { "type": "integer", "default": 1, "description": "Page for paginating large diffs (when a commit touches many files)" },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo", "sha"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_file_contents.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner (user or org)" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "path": { "type": "string", "description": "File path within the repository (e.g. 'src/index.js')" },
+    "ref": { "type": "string", "description": "Branch name, tag, or commit SHA (defaults to the repo's default branch)" }
+  },
+  "required": ["owner", "repo", "path"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_job_logs.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "job_id": { "type": "integer", "description": "Workflow job ID. Get this from the 'jobs' field of get_workflow_run, or from the GitHub Actions UI URL." }
+  },
+  "required": ["owner", "repo", "job_id"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_pull_request.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_pull_request_diff.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_repo_tree.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner (user or org)" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "ref": { "type": "string", "description": "Branch name, tag, or commit SHA (defaults to HEAD)" },
+    "recursive": { "type": "boolean", "description": "Return the full recursive tree (all nested files). Default true.", "default": true },
+    "path_filter": { "type": "string", "description": "Optional path prefix to filter results (e.g. 'src/')" }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/get_workflow_run.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "run_id": { "type": "integer", "description": "Workflow run ID (obtain from list_workflow_runs)" }
+  },
+  "required": ["owner", "repo", "run_id"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_branches.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "protected": { "type": "boolean", "description": "Filter to only protected branches" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_commits.json

@@ -3,9 +3,11 @@
   "properties": {
     "owner": { "type": "string" },
     "repo": { "type": "string" },
-    "sha": { "type": "string" },
-    "path": { "type": "string" },
-    "author": { "type": "string" }
+    "sha": { "type": "string", "description": "Branch name, tag, or commit SHA to start listing from (defaults to default branch)" },
+    "path": { "type": "string", "description": "Filter commits that touch this file path" },
+    "author": { "type": "string", "description": "Filter by GitHub username or email address" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
   },
   "required": ["owner", "repo"],
   "additionalProperties": false

package/integrations/github/schemas/list_issue_comments.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "issue_number": { "type": "integer", "description": "Issue number" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo", "issue_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_issues.json

@@ -4,8 +4,10 @@
     "owner": { "type": "string" },
     "repo": { "type": "string" },
     "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" },
-    "labels": { "type": "string" },
-    "assignee": { "type": "string" }
+    "labels": { "type": "string", "description": "Comma-separated list of label names to filter by" },
+    "assignee": { "type": "string", "description": "Filter by assignee username, or 'none' for unassigned, '*' for any" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
   },
   "required": ["owner", "repo"],
   "additionalProperties": false

package/integrations/github/schemas/list_labels.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 100, "maximum": 100 }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_pull_request_comments.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_pull_request_files.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_pull_requests.json

@@ -3,7 +3,13 @@
   "properties": {
     "owner": { "type": "string" },
     "repo": { "type": "string" },
-    "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" }
+    "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" },
+    "head": { "type": "string", "description": "Filter by head user/org and branch (e.g. 'user:my-branch')" },
+    "base": { "type": "string", "description": "Filter by base branch name (e.g. 'main')" },
+    "sort": { "type": "string", "enum": ["created", "updated", "popularity", "long-running"], "default": "created" },
+    "direction": { "type": "string", "enum": ["asc", "desc"], "default": "desc" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
   },
   "required": ["owner", "repo"],
   "additionalProperties": false

package/integrations/github/schemas/list_releases.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_tags.json

@@ -0,0 +1,11 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/list_workflow_runs.json

@@ -0,0 +1,18 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "branch": { "type": "string", "description": "Filter runs by branch name" },
+    "status": {
+      "type": "string",
+      "enum": ["queued", "in_progress", "completed", "action_required", "cancelled", "failure", "neutral", "skipped", "stale", "success", "timed_out", "waiting"],
+      "description": "Filter by run status or conclusion"
+    },
+    "event": { "type": "string", "description": "Filter by triggering event (e.g. 'push', 'pull_request', 'schedule', 'workflow_dispatch')" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["owner", "repo"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/request_pull_request_reviewers.json

@@ -0,0 +1,20 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number" },
+    "reviewers": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "GitHub usernames to request reviews from"
+    },
+    "team_reviewers": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Team slugs to request reviews from (org repos only)"
+    }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/search_code.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "query": { "type": "string", "description": "GitHub code search query. Examples: 'useState repo:facebook/react language:typescript', 'console.log path:src/ language:javascript org:my-org'. Supports language, path, repo, org, and extension filters." },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["query"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/search_issues.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "query": { "type": "string", "description": "GitHub issue search query (e.g. 'is:open is:issue label:bug repo:owner/repo', 'is:open assignee:@me', 'is:issue no:assignee'). Supports all GitHub search qualifiers." },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["query"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/search_pull_requests.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "query": { "type": "string", "description": "GitHub search query for PRs. Use 'is:pr' to scope to PRs (e.g. 'is:pr is:open author:octocat label:bug repo:owner/repo'). Supports all GitHub issue search qualifiers." },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["query"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/search_repos.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "query": { "type": "string", "description": "GitHub repository search query. Examples: 'machine learning language:python stars:>1000', 'topic:react', 'user:facebook is:public'. Supports stars, forks, language, topic, and many other qualifiers." },
+    "sort": { "type": "string", "enum": ["stars", "forks", "help-wanted-issues", "updated"], "description": "Sort repos by this field" },
+    "order": { "type": "string", "enum": ["asc", "desc"], "default": "desc" },
+    "page": { "type": "integer", "default": 1 },
+    "per_page": { "type": "integer", "default": 30, "maximum": 100 }
+  },
+  "required": ["query"],
+  "additionalProperties": false
+}

package/integrations/github/schemas/update_pull_request.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "Repository owner" },
+    "repo": { "type": "string", "description": "Repository name" },
+    "pull_number": { "type": "integer", "description": "Pull request number to update" },
+    "title": { "type": "string", "description": "New title for the PR" },
+    "body": { "type": "string", "description": "New description for the PR (markdown)" },
+    "state": { "type": "string", "enum": ["open", "closed"], "description": "Set to 'closed' to close the PR without merging" },
+    "base": { "type": "string", "description": "New base branch to merge into" },
+    "draft": { "type": "boolean", "description": "Set to true to convert to draft, false to mark ready for review" }
+  },
+  "required": ["owner", "repo", "pull_number"],
+  "additionalProperties": false
+}

package/integrations/google-calendar/.env.test.example

@@ -0,0 +1,11 @@
+# Google Calendar live integration tests
+# Shared Google credentials live in /.env.test.google — set those up first.
+#
+# Calendar ID to run tests against (defaults to 'primary' if omitted)
+GOOGLE_CALENDAR_TEST_CALENDAR_ID=
+# Set to any non-empty value to enable admin write tests (creates/deletes calendars)
+GOOGLE_CALENDAR_TEST_ADMIN_WRITE=
+# A plain-text quick-add string for the quick_add_event test (e.g. "Lunch tomorrow at noon")
+GOOGLE_CALENDAR_TEST_QUICK_ADD=
+# Calendar ID to use as the move destination in move_event tests
+GOOGLE_CALENDAR_TEST_MOVE_DEST=

package/integrations/google-calendar/README.md

@@ -0,0 +1,41 @@
+# Google Calendar
+
+**17 tools** across 2 toolsets
+
+![Google Calendar tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-google-calendar.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `service_account` | Service Account (recommended) _(default)_ |
+| `oauth_token` | OAuth Access Token (short-lived) |
+
+## Toolsets
+
+| Toolset | Description |
+|---|---|
+| `events` | Browse, schedule, and manage calendar events |
+| `sharing` | Control who can access calendars |
+
+## Tools
+
+| Tool | Scope | Toolset | Description |
+|---|---|---|---|
+| `list_calendars` | read | `events` | List all calendars in the authenticated user's calendar list, including the primary calen… |
+| `get_calendar` | read | `events` | Get details for a specific calendar by ID, including its summary, description, timezone, … |
+| `list_events` | read | `events` | List events in a calendar with optional time range, text search, and pagination. Use cale… |
+| `get_event` | read | `events` | Get a specific event by its ID from a calendar. Returns full event details including summ… |
+| `list_colors` | read | `events` | Get the set of color definitions available for calendars and events. Returns colorId valu… |
+| `freebusy_query` | read | `events` | Query free/busy availability for one or more calendars within a time range. Useful for fi… |
+| `list_settings` | read | `events` | List the authenticated user's Google Calendar settings, such as timezone, date format, an… |
+| `create_event` | write | `events` | Create a new event in a calendar. Required fields: calendarId, summary, start, end. Use {… |
+| `patch_event` | write | `events` | Partially update an event by providing only the fields to change. All other fields are pr… |
+| `delete_event` | write | `events` | Delete an event from a calendar. This permanently removes the event. For recurring events… |
+| `move_event` | write | `events` | Move an event from one calendar to another. Provide the source calendarId, eventId, and t… |
+| `quick_add` | write | `events` | Create an event using a natural language text string. Parses the text to extract event de… |
+| `list_acl` | admin | `sharing` | List the Access Control List (ACL) rules for a calendar. Returns rules defining who has a… |
+| `get_acl` | admin | `sharing` | Get a specific ACL rule by its rule ID for a calendar. Use list_acl to find rule IDs. |
+| `insert_acl` | admin | `sharing` | Add a new ACL rule to grant a user or group access to a calendar. Roles: 'reader' (view),… |
+| `update_acl` | admin | `sharing` | Update an existing ACL rule to change a user's or group's permission level on a calendar.… |
+| `delete_acl` | admin | `sharing` | Remove an ACL rule from a calendar, revoking the associated user's or group's access. Use… |