Agent Skills › memoe-app/memoe › composio-google-drive

composio-google-drive

GitHub

提供通过 Composio 调用 Google Drive API 的最佳实践,包括工具选择、fields 参数优化及输入输出区分。

moe-home/hermes-skills/connectors/composio-google-drive/SKILL.md memoe-app/memoe

Trigger Scenarios

使用 Composio 集成 Google Drive 查询 Google Drive 文件元数据或内容 优化 Drive API 调用成本

Install

npx skills add memoe-app/memoe --skill composio-google-drive -g -y
More Options

Non-standard path

npx skills add https://github.com/memoe-app/memoe/tree/main/moe-home/hermes-skills/connectors/composio-google-drive -g -y

Use without installing

npx skills use memoe-app/memoe@composio-google-drive

指定 Agent (Claude Code)

npx skills add memoe-app/memoe --skill composio-google-drive -a claude-code -g -y

安装 repo 全部 skill

npx skills add memoe-app/memoe --all -g -y

预览 repo 内 skill

npx skills add memoe-app/memoe --list

SKILL.md

Frontmatter
{
    "name": "composio-google-drive",
    "author": "Moe",
    "license": "MIT",
    "version": "1.0.0",
    "metadata": {
        "hermes": {
            "tags": [
                "Composio",
                "Drive",
                "Google",
                "Files",
                "MCP"
            ],
            "toolkit": "googledrive",
            "related_skills": [
                "composio-router",
                "composio-google-docs",
                "composio-google-sheets"
            ]
        }
    },
    "description": "Read before any GOOGLEDRIVE_* call through Composio. Finding a file versus reading one, why a `fields` value Drive does not recognise costs FOUR TIMES more than omitting it, and the nine of GOOGLEDRIVE_FIND_FILE's twenty-two 'inputs' that are not inputs at all."
}

Google Drive through Composio

Read composio-router first for the method. Measured 2026-09-04 against a real Drive.

Which tool answers which question

the question the tool
find a file by name, type, date, folder GOOGLEDRIVE_FIND_FILE
everything in this folder / a plain listing GOOGLEDRIVE_LIST_FILES
one file's metadata, given its id GOOGLEDRIVE_GET_FILE_METADATA
how much space is left / whose Drive is this GOOGLEDRIVE_GET_ABOUT
the file's actual contents GOOGLEDRIVE_DOWNLOAD_FILE, or GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE for a Doc/Sheet/Slide

A Google Doc, Sheet or Slide has no bytes to download — it is not a file in that sense. Reading one means exporting it, or better, using the toolkit that owns it: composio-google-docs, composio-google-sheets.

fields: the wrong value costs four times the right one

This is the finding worth carrying off this page.

fields omitted                 1,041 B    the documented "discovery" default
fields: "files(id,name)"         555 B    a real Google field selector
fields: "basic"                4,008 B    NOT a selector
fields: "*"                    4,006 B    everything

fields takes Google's field-mask syntax. A value that is not one — "basic", "full", a word you assumed was an enum — does not error. It falls back to returning everything, which costs four times what you would have paid by leaving the parameter out. Pass a real selector or pass nothing; never pass a guess.

GOOGLEDRIVE_GET_ABOUT is the same lever, larger:

fields omitted (documented default '*')   14,341 B
fields: "user"                                544 B     26x
fields: "storageQuota"                        398 B

Here the default really is '*', on purpose. Always name the field you want.

Nine of twenty-two "inputs" are outputs

GOOGLEDRIVE_FIND_FILE advertises 22 input properties. Nine of them are notes the tool writes about what it did to your request:

pagetoken_dropped              editors_field_removed
email_query_transformed        emailaddress_field_removed
bare_text_query_transformed    orderby_size_transformed
original_email_query           original_bare_text_query
original_invalid_pagetoken

Setting them means nothing. They are 40% of that tool's 11.9 KB schema. The parameters that actually do something are q, folder_id, fields, orderBy, pageSize (default 100) and pageToken.

GOOGLESHEETS_BATCH_GET carries the same shape in empty_strings_filtered, so expect it elsewhere: a boolean whose description begins "Indicates whether" is a result, not a request.

Searching

q takes both bare text (auto-converted to a full-text search) and Drive query syntax:

q: "name contains 'invoice'"
q: "mimeType = 'application/pdf'"
q: "modifiedTime > '2026-09-01T00:00:00'"

orderBy cannot be combined with a full-text term in q. corpora defaults to allDrives, so shared drives are already included.

Do not read a person's files to measure them

Sizes, counts and key names are fair to record. File names and contents are not — not in a note, a log, a filename or a hand-off to another agent.

Version History

  • e2735d6 Current 2026-11-20 21:42

Same Skill Collection

moe-home/hermes-skills/connectors/composio-gmail/SKILL.md
moe-home/hermes-skills/connectors/composio-google-calendar/SKILL.md
moe-home/hermes-skills/connectors/composio-google-docs/SKILL.md
moe-home/hermes-skills/connectors/composio-google-meet/SKILL.md
moe-home/hermes-skills/connectors/composio-google-sheets/SKILL.md
moe-home/hermes-skills/connectors/composio-google-tasks/SKILL.md
moe-home/hermes-skills/connectors/composio-router/SKILL.md
moe-home/hermes-skills/writing/humanizer/SKILL.md

Metadata

Files
0
Version
e2735d6
Hash
2a882e80
Indexed
2026-11-20 21:42

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-20 23:48
浙ICP备14020137号-1