Yuk, Belajar Cara Connect Gmail ke AI Agent Pakai Composio

Inbox yang terus bertambah bisa menjadi pekerjaan tersendiri bagi tim bisnis. Dengan connect Gmail ke AI Agent pakai Composio, proses membaca, memilah, hingga menindaklanjuti email dapat diotomatisasi. Artikel ini membahas konsep, cara kerja, implementasi, dan use case Hermes Agent untuk membangun otomatisasi email yang lebih efisien.

Apa Artinya “Connecting Gmail”?

Menghubungkan Gmail ke AI agent artinya memberikan akses tertentu agar agent dapat berinteraksi dengan akun Gmail. Akses tersebut diberikan melalui OAuth token dengan permission atau scope yang menentukan apa saja yang boleh dilakukan agent terhadap email.

Bagian ini penting karena tidak semua akses Gmail memiliki tingkat kewenangan yang sama. Gmail API menyediakan beberapa level permission, mulai dari hanya membaca email hingga mengelola dan menghapus pesan.

Baca Juga: Checklist Keamanan Cloud VPS Sebelum Go-Live, Jangan Skip!

Beberapa scope yang umum antara lain:

• gmail.readonly: agent hanya dapat membaca email tanpa mengubah atau menghapusnya.
• gmail.send: agent dapat mengirim email atas nama pengguna, tetapi tidak dapat membaca inbox.
• gmail.compose: agent dapat membuat dan mengirim email serta mengelola draft.
• gmail.modify: agent dapat membaca, mengirim, menghapus, serta mengubah label email.
• mail.google.com: memberikan akses penuh terhadap akun Gmail.

Untuk kebutuhan email bisnis, prinsip least privilege sebaiknya tetap digunakan. Berikan hanya permission yang benar-benar diperlukan oleh agent. Jika agent hanya bertugas merangkum email, misalnya, akses read-only sudah lebih masuk akal dibanding memberikan akses penuh.

Dengan pendekatan tersebut, integrasi Gmail bukan sekadar soal membuat AI bisa “melihat inbox”, tetapi menentukan dengan jelas sejauh mana AI diperbolehkan mengambil tindakan.

Baca Juga: Tools, Plugin, dan MCP Hermes Agent yang Wajib Kamu Coba!

Kenapa AI Agent Butuh Akses Gmail?

Volume email menjadi alasan paling sederhana. Profesional dapat menerima dan mengirim lebih dari 120 email dalam sehari, sementara sebagian email memiliki pola respons yang repetitif. Jika semuanya ditangani secara manual, waktu produktif tim akan banyak terserap untuk pekerjaan administratif.

Masalahnya, fitur native Gmail seperti Smart Compose masih bekerja pada level bantuan penulisan. Fitur tersebut belum dirancang untuk menjalankan alur kerja bisnis secara menyeluruh berdasarkan konteks email.

Di sinilah AI agent memiliki peran berbeda.

Dengan akses ke Gmail, agent dapat membaca isi email, memahami thread sebelumnya, mencari pesan tertentu, membuat draft, mengelompokkan email, hingga menjalankan tindakan lanjutan. Jadi, agent tidak hanya memberi tahu bahwa ada email baru, tetapi dapat membantu menyelesaikan pekerjaan yang muncul dari email tersebut.

Misalnya, sebuah email pelanggan meminta jadwal onboarding. AI agent dapat membaca permintaan tersebut, memahami konteks percakapan, lalu memicu workflow untuk membuat jadwal atau memberi notifikasi kepada tim terkait.

Dalam arsitektur seperti ini, Composio Connect berperan sebagai lapisan eksekusi yang menjembatani kemampuan reasoning AI dengan berbagai aplikasi yang digunakan bisnis.

Composio memungkinkan agent mengakses Gmail dan tools lain tanpa harus membangun seluruh integrasi OAuth secara manual dari awal.

Cara Connect Gmail ke AI Agent Menggunakan Composio

Sebelum mulai, siapkan tiga hal: akun Composio, akun Gmail yang ingin dihubungkan, serta AI agent atau workflow yang sudah tersedia, misalnya custom agent atau n8n.

Langkah 1: Install Composio di Infrastruktur VPS Hermes Agent (Cloudbaik)

Sebelum memulai instalasi Composio, pastikan kamu sudah menggunakan layanan VPS Hermes Agent di Cloudbaik. Pastikan Hermes Agent sudah aktif dan dapat diakses melalui SSH. 

Tahap ini penting karena Composio akan berjalan sebagai integration layer di dalam environment Hermes, sehingga seluruh koneksi AI agent (Gmail, Slack, Notion, dan tools lain) berada dalam satu sistem yang terpusat dan stabil.

#1. Akses VPS Hermes Agent via SSH

Login ke server VPS Hermes Agent menggunakan SSH:

ssh root@your-vps-ip

Pastikan environment Hermes sudah berjalan dengan benar sebelum melanjutkan instalasi Composio. Jika Hermes belum aktif, selesaikan setup awal terlebih dahulu agar tidak terjadi konflik dependency.

#2. Install Composio sebagai Dependency AI Agent

Setelah masuk ke VPS, install Composio di dalam project Hermes Agent:

npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp

Package ini akan menambahkan Composio sebagai tool orchestration layer, yang memungkinkan AI agent di Hermes untuk:

• Mengakses Gmail API
• Menghubungkan Slack, Notion, dan tools lain
• Menjalankan workflow berbasis tool calling
• Mengelola MCP (Model Context Protocol) server

#3. Validasi Instalasi di Environment Hermes

Setelah instalasi selesai, pastikan dependency Composio sudah terdaftar di project Hermes:

npm list @composio/core

Jika tidak ada error, berarti Composio sudah berhasil terintegrasi ke environment VPS Hermes Agent.

Pada tahap ini, Composio sudah siap digunakan sebagai jembatan antara AI agent dan external services.

#4. Siapkan Konfigurasi Awal Composio

Setelah instalasi berhasil, langkah berikutnya adalah menyiapkan konfigurasi dasar Composio:

• Buat akun Composio
• Ambil API key dari dashboard
• Siapkan MCP server endpoint
• Hubungkan MCP ke Hermes Agent

Konfigurasi ini akan memungkinkan AI agent di VPS Hermes untuk menjalankan workflow secara end-to-end, mulai dari membaca email Gmail hingga mengeksekusi action di aplikasi lain.

Dengan setup ini, Hermes Agent + Composio di Cloud VPS Cloudbaik akan menjadi environment yang siap untuk production use case, dengan arsitektur yang lebih stabil, scalable, dan mudah dikembangkan untuk kebutuhan AI automation.

Langkah 2: Buat Tool Router Session

Setelah package terpasang, inisialisasi Composio menggunakan API key dan buat session untuk user yang akan menggunakan agent.

import { Composio } from '@composio/core';

const composio = new Composio({

  apiKey: 'your-api-key'

});

const { mcp } = await composio.create('your-user-id');

console.log(`Tool Router session created: ${mcp.url}`);

Session tersebut menghasilkan endpoint MCP yang nantinya digunakan oleh AI agent untuk mengakses tools yang tersedia.

Langkah 3: Hubungkan MCP ke AI Agent

Berikutnya, MCP server dapat dihubungkan ke AI agent menggunakan AI SDK.

const client = await createMCPClient({

  transport: {

    type: 'http',

    url: mcp.url,

    headers: {

      'x-api-key': 'your-composio-api-key'

    }

  }

});

const tools = await client.tools();

Setelah tools tersedia, agent dapat diberikan instruksi untuk bekerja dengan email. Contohnya:

Summarize unread emails from this morning

Agent kemudian dapat menggunakan tool yang tersedia untuk membaca email dan menghasilkan rangkuman.

Dalam pendekatan lain, Composio juga dapat digunakan bersama OpenAI Responses API. Tool dari Tool Router diberikan kepada model, kemudian hasil pemanggilan tool diproses kembali melalui provider Composio.

Bagaimana AI Email Agent Mengelola Gmail?

Setelah integrasi Composio dan Gmail berhasil, manfaatnya mulai terlihat ketika Gmail diposisikan sebagai pintu masuk workflow bisnis.

Memprioritaskan Email yang Benar-Benar Penting

AI agent tidak harus menentukan prioritas hanya berdasarkan kata seperti “urgent”. Agent dapat mempertimbangkan hubungan pengirim dengan bisnis, riwayat percakapan, thread sebelumnya, serta dampaknya terhadap pelanggan.

Misalnya, email dari pelanggan enterprise yang sedang menghadapi masalah implementasi tentu memiliki prioritas berbeda dibanding newsletter marketing.

Agent juga dapat membuat ranking email dan menjelaskan alasan di balik prioritas tersebut.

Memisahkan Email Informasional dan Actionable

Inbox bisnis biasanya berisi invoice, newsletter, notifikasi sistem, laporan internal, undangan meeting, hingga permintaan yang membutuhkan keputusan.

AI agent dapat mengklasifikasikan email berdasarkan intent, misalnya:

• Action Required
• Waiting for Reply
• Reference Material
• Newsletter
• Notification
• Archive

Hasilnya, tim dapat lebih fokus pada email yang benar-benar membutuhkan tindakan.

Mendeteksi Follow-Up yang Terlupakan

Tidak semua email penting terlihat mendesak. Percakapan dengan calon pelanggan dapat berhenti tanpa disadari, vendor bisa menunggu jawaban, dan kandidat rekrutmen dapat terlambat mendapatkan follow-up.

AI agent dapat memantau thread yang tidak mendapatkan balasan selama periode tertentu, lalu membuat daftar follow-up dan bahkan menyiapkan draft email berdasarkan konteks percakapan sebelumnya.

Mengubah Email Menjadi Workflow Otomatis

Bagian yang paling menarik adalah ketika email tidak lagi menjadi tujuan akhir.

Contohnya, email pelanggan yang menyatakan siap onboarding dapat memicu beberapa tindakan sekaligus: membuat data CRM, membuat project, menjadwalkan meeting, mengirim notifikasi ke tim, dan mengirim email welcome.

Dengan platform seperti Composio, agent dapat menghubungkan Gmail dengan berbagai aplikasi bisnis sehingga satu email dapat menjadi pemicu workflow end-to-end.

Bagaimana dengan Keamanan Data Gmail?

Untuk penggunaan di bisnis, keamanan harus dipikirkan dari awal. Composio sudah punya standar keamanan seperti SOC 2 dan ISO 27001, dan semua data penting seperti token dan key dienkripsi (dibuat tidak bisa dibaca sembarangan), baik saat dikirim maupun disimpan.

Saat menghubungkan Gmail, password tidak diberikan ke aplikasi atau AI. Kamu login langsung ke Google, lalu Composio hanya menyimpan “kunci akses” agar sistem bisa terhubung. Kunci ini juga bisa dicabut kapan saja lewat akun Google.

Meski begitu, perusahaan tetap perlu aturan tambahan, seperti membatasi akses AI, meminta persetujuan manusia untuk email penting, mencatat aktivitas AI, dan mengatur siapa yang boleh mengakses apa.

Kesimpulan

Connect Gmail ke AI Agent pakai Composio membuka peluang untuk mengubah inbox dari sekadar kanal komunikasi menjadi pintu masuk otomatisasi bisnis. Dengan integrasi Gmail API dan Gmail MCP server, AI agent dapat membaca konteks percakapan, menyusun respons, mengklasifikasikan email, mendeteksi follow-up, hingga menjalankan workflow lintas aplikasi.

Untuk bisnis yang mulai membangun AI agent untuk email bisnis, tantangannya bukan hanya integrasi aplikasi, tetapi juga memastikan agent memiliki infrastruktur yang stabil untuk berjalan secara konsisten.

Di sinilah VPS Hermes Agent dari Cloudbaik dapat menjadi pilihan infrastruktur untuk kebutuhan otomatisasi berbasis AI. Dengan server yang dirancang untuk menjalankan workload agent dan workflow automation, kamu dapat membangun lingkungan yang lebih terkontrol, andal, dan siap dikembangkan sesuai kebutuhan bisnis.

Ketika volume email dan workflow semakin besar, infrastruktur yang tepat membantu tim tidak sekadar mengotomatisasi pekerjaan, tetapi membangun sistem operasional yang mampu berkembang bersama bisnis.