Skip to content

Cloud Services

AWS S3, Azure Blob, Google Cloud Storage, and Google Workspace integrations.

14 modules

ModuleDescription
S3 オブジェクト削除AWS S3バケットからオブジェクトを削除
S3 ダウンロードAWS S3バケットからローカルパスにファイルをダウンロード
S3 オブジェクト一覧AWS S3バケット内のオブジェクトをオプションのプレフィックスフィルターで一覧表示
S3 アップロードローカルファイルをAWS S3バケットにアップロード
AWS S3 ダウンロードAWS S3バケットからファイルをダウンロード
AWS S3 アップロードAWS S3バケットにファイルまたはデータをアップロード
Azure ダウンロードAzure Blob Storageからファイルをダウンロード
Azure アップロードAzure Blob Storageにファイルをアップロード
GCS ダウンロードGoogle Cloud Storageからファイルをダウンロード
GCS アップロードGoogle Cloud Storageにファイルをアップロード
カレンダーイベント作成Googleカレンダーに新しいイベントを作成
カレンダーイベント一覧Googleカレンダーから今後のイベントを一覧表示
Gmail検索Gmail検索クエリ構文を使ってGmailメッセージを検索
Gmail送信Gmail APIを使ってメールを送信

Modules

S3 オブジェクト削除

aws.s3.delete

AWS S3バケットからオブジェクトを削除

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
keystringYes-S3 object key to delete
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)

Output:

FieldTypeDescription
bucketstringS3バケット名
keystring削除されたオブジェクトキー
deletedbooleanオブジェクトが正常に削除されたかどうか

Example: Delete an object

yaml
bucket: my-bucket
key: uploads/old-file.txt

S3 ダウンロード

aws.s3.download

AWS S3バケットからローカルパスにファイルをダウンロード

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
keystringYes-S3 object key (path in bucket)
output_pathstringYes-Local file path to save the downloaded file
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)

Output:

FieldTypeDescription
pathstringファイルが保存されたローカルパス
sizenumberファイルサイズ(バイト)
content_typestringダウンロードされたファイルのMIMEタイプ

Example: Download a file from S3

yaml
bucket: my-bucket
key: data/report.csv
output_path: /tmp/report.csv

S3 オブジェクト一覧

aws.s3.list

AWS S3バケット内のオブジェクトをオプションのプレフィックスフィルターで一覧表示

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
prefixstringNo-Filter objects by key prefix (e.g. "uploads/")
max_keysnumberNo100Maximum number of objects to return
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)

Output:

FieldTypeDescription
objectsarrayS3オブジェクトの一覧
countnumber返されたオブジェクトの数
truncatedboolean結果が切り捨てられたかどうか

Example: List objects with prefix

yaml
bucket: my-bucket
prefix: uploads/
max_keys: 50

S3 アップロード

aws.s3.upload

ローカルファイルをAWS S3バケットにアップロード

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
keystringYes-S3 object key (path in bucket)
file_pathstringYes-Local file path to upload
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)
content_typestringNo-MIME type of the file (auto-detected if not set)

Output:

FieldTypeDescription
bucketstringS3バケット名
keystringS3オブジェクトキー
urlstringアップロードされたオブジェクトの公開URL
sizenumberファイルサイズ(バイト)

Example: Upload a local file

yaml
bucket: my-bucket
key: data/report.csv
file_path: /tmp/report.csv

AWS S3 ダウンロード

cloud.aws_s3.download

AWS S3バケットからファイルをダウンロード

Parameters:

NameTypeRequiredDefaultDescription
aws_access_key_idstringNo-AWSアクセスキーID(デフォルト: env.AWS_ACCESS_KEY_ID)
aws_secret_access_keystringNo-AWSシークレットアクセスキー(デフォルト: env.AWS_SECRET_ACCESS_KEY)
regionstringNous-east-1AWSリージョン(デフォルト: env.AWS_REGION または us-east-1)
bucketstringYes-S3バケット名
keystringYes-S3バケット名
file_pathstringNo-S3オブジェクトキー(バケット内のファイルパス)

Output:

FieldTypeDescription
contentstringFile content (if file_path not provided)
file_pathstringPath where file was saved (if file_path provided)
sizenumberFile size in bytes
content_typestringMIME type of the file

Example: Download to memory

yaml
bucket: my-bucket
key: data/config.json

Example: Download to file

yaml
bucket: my-bucket
key: backups/database.sql
file_path: /tmp/downloaded.sql

AWS S3 アップロード

cloud.aws_s3.upload

AWS S3バケットにファイルまたはデータをアップロード

Parameters:

NameTypeRequiredDefaultDescription
aws_access_key_idstringNo-AWSアクセスキーID(デフォルト: env.AWS_ACCESS_KEY_ID)
aws_secret_access_keystringNo-AWSシークレットアクセスキー(デフォルト: env.AWS_SECRET_ACCESS_KEY)
regionstringNous-east-1AWSリージョン(デフォルト: env.AWS_REGION または us-east-1)
bucketstringYes-S3バケット名
keystringYes-S3バケット名
file_pathstringNo-S3オブジェクトキー(バケット内のファイルパス)
contentstringNo-アップロードするローカルファイルパス
content_typestringNo-ファイルのMIMEタイプ
aclstringNoprivateファイルのMIMEタイプ

Output:

FieldTypeDescription
urlstringアップロードされたオブジェクトのS3 URL
bucketstringアップロードされたオブジェクトのS3 URL
keystringアップロードされたオブジェクトのS3 URL
etagstringバケット名

Example: Upload text content

yaml
bucket: my-bucket
key: reports/daily-${timestamp}.txt
content: ${report_text}
content_type: text/plain

Example: Upload local file

yaml
bucket: my-bucket
key: backups/database.sql
file_path: /tmp/backup.sql
acl: private

Azure ダウンロード

cloud.azure.download

Azure Blob Storageからファイルをダウンロード

Parameters:

NameTypeRequiredDefaultDescription
connection_stringstringNo-Azure Storage接続文字列(環境変数 AZURE_STORAGE_CONNECTION_STRING を使用)
containerstringYes-Azure Storage接続文字列(環境変数 AZURE_STORAGE_CONNECTION_STRING を使用)
blob_namestringYes-Azureコンテナ名
destination_pathstringYes-ダウンロードするBlob

Output:

FieldTypeDescription
file_pathstringThe file path
sizenumberSize in bytes
containerstringThe container
blob_namestringThe blob name

Example: Download backup

yaml
container: backups
blob_name: data/backup-2024.zip
destination_path: /tmp/backup.zip

Example: Download image

yaml
container: images
blob_name: photos/vacation.jpg
destination_path: /tmp/photo.jpg

Azure アップロード

cloud.azure.upload

Azure Blob Storageにファイルをアップロード

Parameters:

NameTypeRequiredDefaultDescription
file_pathstringYes-アップロードするローカルファイルパス
connection_stringstringNo-アップロードするローカルファイルパス
containerstringYes-Azure Storage接続文字列(環境変数 AZURE_STORAGE_CONNECTION_STRING を使用)
blob_namestringNo-Azureコンテナ名
content_typestringNo-アップロードされるBlobの名前(デフォルト: ファイル名)

Output:

FieldTypeDescription
urlstringMIMEタイプ(任意)
containerstringMIMEタイプ(任意)
blob_namestringURLアドレス
sizenumberコンテナ

Example: Upload image

yaml
file_path: /tmp/screenshot.png
container: images
blob_name: screenshots/2024/screenshot.png
content_type: image/png

Example: Upload document

yaml
file_path: /tmp/report.pdf
container: documents
blob_name: reports/monthly.pdf

GCS ダウンロード

cloud.gcs.download

Google Cloud Storageからファイルをダウンロード

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-GCSバケット名
object_namestringYes-GCSバケット名
destination_pathstringYes-ダウンロードするオブジェクト

Output:

FieldTypeDescription
file_pathstringThe file path
sizenumberSize in bytes
bucketstringStorage bucket name
object_namestringObject name in storage

Example: Download backup

yaml
bucket: my-backups
object_name: data/backup-2024.zip
destination_path: /tmp/backup.zip

Example: Download image

yaml
bucket: image-storage
object_name: photos/vacation.jpg
destination_path: /tmp/photo.jpg

GCS アップロード

cloud.gcs.upload

Google Cloud Storageにファイルをアップロード

Parameters:

NameTypeRequiredDefaultDescription
file_pathstringYes-アップロードするローカルファイルパス
bucketstringYes-アップロードするローカルファイルパス
object_namestringNo-GCSバケット名
content_typestringNo-アップロードされるオブジェクトの名前(デフォルト: ファイル名)
publicbooleanNoFalseMIMEタイプ(任意)

Output:

FieldTypeDescription
urlstringファイルを公開アクセス可能にする
bucketstringファイルを公開アクセス可能にする
object_namestringURLアドレス
sizenumberストレージバケット名
public_urlstringストレージ内のオブジェクト名

Example: Upload image

yaml
file_path: /tmp/screenshot.png
bucket: my-bucket
object_name: screenshots/2024/screenshot.png
content_type: image/png
public: true

Example: Upload CSV data

yaml
file_path: /tmp/report.csv
bucket: data-backup
object_name: reports/daily.csv

カレンダーイベント作成

google.calendar.create_event

Googleカレンダーに新しいイベントを作成

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Calendar write scope
summarystringYes-Title of the calendar event
start_timestringYes-Event start time in ISO 8601 format
end_timestringYes-Event end time in ISO 8601 format
descriptionstringNo-Detailed description of the event
locationstringNo-Event location or meeting link
attendeesstringNo-Comma-separated list of attendee email addresses
timezonestringNoUTCTimezone for the event (IANA timezone)

Output:

FieldTypeDescription
event_idstring作成されたイベントID
summarystringイベントタイトル
startstringイベント開始時間
endstringイベント終了時間
html_linkstringGoogleカレンダーでイベントを見るためのリンク

Example: Create a meeting event

yaml
access_token: <oauth2-token>
summary: Sprint Planning
start_time: 2026-03-01T10:00:00
end_time: 2026-03-01T11:00:00
attendees: alice@example.com, bob@example.com
timezone: America/New_York

カレンダーイベント一覧

google.calendar.list_events

Googleカレンダーから今後のイベントを一覧表示

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Calendar read scope
max_resultsnumberNo10Maximum number of events to return
time_minstringNo-Only return events starting after this time (ISO 8601). Defaults to now.
time_maxstringNo-Only return events starting before this time (ISO 8601)

Output:

FieldTypeDescription
eventsarrayカレンダーイベントのリスト
countnumber返されたイベントの数

Example: List next 5 events

yaml
access_token: <oauth2-token>
max_results: 5

Gmail検索

google.gmail.search

Gmail検索クエリ構文を使ってGmailメッセージを検索

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Gmail read scope
querystringYes-Gmail search query (e.g. "from:user@example.com subject:invoice")
max_resultsnumberNo10Maximum number of messages to return

Output:

FieldTypeDescription
messagesarray一致するメッセージのリスト
totalnumber返されたメッセージの総数

Example: Search for emails from a specific sender

yaml
access_token: <oauth2-token>
query: from:boss@company.com is:unread
max_results: 5

Gmail送信

google.gmail.send

Gmail APIを使ってメールを送信

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Gmail send scope
tostringYes-Recipient email address
subjectstringYes-Email subject line
bodystringYes-Email body content
htmlbooleanNoFalseWhether the body is HTML content
ccstringNo-CC email address(es), comma-separated
bccstringNo-BCC email address(es), comma-separated

Output:

FieldTypeDescription
message_idstringGmailメッセージID
thread_idstringGmailスレッドID
tostring受信者のメールアドレス

Example: Send a plain text email

yaml
access_token: <oauth2-token>
to: user@example.com
subject: Test Email
body: Hello, this is a test email.

Released under the Apache 2.0 License.