Resend Email

resmi

Kirim email langsung dari editor Anda menggunakan API Resend.

Apa yang bisa Anda lakukan dengan Resend Email MCP?

  • Kirim dan jadwalkan email — Minta asisten Anda mengirim email HTML atau teks biasa dengan CC/BCC, alamat balasan, lampiran, tag, dan penjadwalan.
  • Kelola kontak dan segmen — Buat, perbarui, dan hapus kontak, kelola keanggotaan segmen dan langganan topik, serta jalankan impor CSV.
  • Jalankan kampanye siaran — Buat, jadwalkan, kirim, atau batalkan siaran, lalu tinjau penerima berdasarkan jenis peristiwa dan tautan yang diklik.
  • Tangani email masuk dan kotak masuk — Daftar dan baca email yang diterima, unduh lampiran, serta kelola utas, label, dan draf kotak masuk.
  • Kelola domain dan penekanan — Buat, verifikasi, dan konfigurasi domain pengirim, serta tambahkan atau hapus entri daftar penekanan.
  • Periksa log dan penggunaan — Tinjau log permintaan API beserta isi permintaan dan respons lengkap, serta periksa penggunaan dan kuota akun.

Server MCP Terhosting

npx add-mcp 'https://mcp.resend.com/mcp'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Resend MCP Server

npm version

Hubungkan agen AI Anda ke platform Resend. Kirim dan terima email, kelola kontak, siaran, domain, dan lainnya, langsung dari klien MCP mana pun seperti Claude, Cursor, atau Claude Code.

Kami menyediakan server MCP jarak jauh yang dihosting oleh Resend dan server MCP lokal (paket ini).

Server MCP Jarak Jauh

Resend menghosting server MCP di:

https://mcp.resend.com/mcp

Hubungkan klien MCP apa pun yang mendukung server jarak jauh (Streamable HTTP). Tidak ada yang perlu diinstal dan tidak ada proses lokal yang perlu dijalankan, sehingga ini menjadi pilihan terbaik untuk klien berbasis web seperti Claude dan platform agen yang dihosting.

Saat Anda terhubung, klien akan membuka jendela browser untuk masuk ke Resend dan menyetujui akses menggunakan OAuth.

Claude Code

claude mcp add --transport http resend https://mcp.resend.com/mcp

Kemudian jalankan /mcp di Claude Code dan pilih resend untuk menyelesaikan login OAuth.

Claude

Di Claude (web atau desktop), buka Settings > Connectors > Add custom connector, lalu masukkan:

https://mcp.resend.com/mcp

Cursor

Buka palet perintah, lalu pilih "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "url": "https://mcp.resend.com/mcp"
    }
  }
}

Codex

codex mcp add resend --url https://mcp.resend.com/mcp

Copilot

Untuk menggunakan GitHub Copilot di VS Code, tambahkan berikut ini ke settings.json:

{
  "mcp": {
    "servers": {
      "resend": {
        "type": "http",
        "url": "https://mcp.resend.com/mcp"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "resend": {
      "serverUrl": "https://mcp.resend.com/mcp"
    }
  }
}

Warp

Di Settings Warp, buka Agents > MCP servers, lalu klik +Add untuk menambahkan server baru.

{
  "resend": {
    "serverUrl": "https://mcp.resend.com/mcp"
  }
}

Autentikasi dengan kunci API

Jika klien Anda berjalan di lingkungan yang tidak memungkinkan login melalui browser (server, CI, atau agen tanpa antarmuka), berikan kunci API Resend sebagai token Bearer, bukan menggunakan OAuth.

Claude Code:

claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Konfigurasi JSON (Cursor, Windsurf, dan lainnya), tambahkan header Authorization:

{
  "mcpServers": {
    "resend": {
      "url": "https://mcp.resend.com/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Server MCP Lokal

Server yang dihosting menjalankan kode sumber terbuka yang sama, tersedia di NPM sebagai resend-mcp. Jika Anda lebih suka menjalankan server sendiri, Anda dapat mengintegrasikannya dengan klien MCP yang didukung menggunakan npx. Anda perlu:

Server lokal mendukung dua mode transportasi: stdio (default) dan HTTP.

Pilih mode dan klien yang Anda inginkan di bawah ini untuk memulai. Ingat untuk mengganti re_xxxxxxxxx dengan kunci API Anda yang sebenarnya.

Transportasi Stdio (Default)

Penyiapan Cepat

Instal untuk semua agen dan editor yang terdeteksi/dipilih:

npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_xxxxxxxxx"

Claude Code

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- npx -y resend-mcp

Codex

codex mcp add resend \
  --env RESEND_API_KEY=re_xxxxxxxxx \
  -- npx -y resend-mcp

Cursor

Buka palet perintah, lalu pilih "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Buka pengaturan Claude Desktop > tab "Developer" > "Edit Config".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Copilot

Untuk menggunakan GitHub Copilot di VS Code, tambahkan berikut ini ke settings.json:

{
  "mcp": {
    "servers": {
      "resend": {
        "command": "npx",
        "args": ["-y", "resend-mcp"],
        "env": {
          "RESEND_API_KEY": "re_xxxxxxxxx"
        }
      }
    }
  }
}

Gemini CLI

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

OpenCode

Tambahkan ke konfigurasi opencode.json Anda:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "resend": {
      "type": "local",
      "command": ["npx", "-y", "resend-mcp"],
      "enabled": true,
      "environment": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Devin

Di Devin, buka Settings > Connections > MCP Servers, lalu klik Add a custom MCP. Lihat panduan Devin untuk langkah-langkah lengkap.

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx",
        "SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
      }
    }
  }
}

Transportasi HTTP

Jalankan server melalui HTTP untuk integrasi jarak jauh atau berbasis web, misalnya di balik tunnel atau reverse proxy milik Anda sendiri, alih-alih menggunakan server MCP jarak jauh yang dihosting oleh Resend. Dalam mode HTTP, setiap klien melakukan autentikasi dengan memberikan kunci API Resend sebagai token Bearer di header Authorization.

Jalankan server:

npx -y resend-mcp --http --port 3000

Server akan mendengarkan di http://127.0.0.1:3000 dan menyediakan endpoint MCP di /mcp menggunakan Streamable HTTP.

Claude Code

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor

Buka palet perintah, lalu pilih "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Anda juga dapat mengatur port melalui variabel lingkungan MCP_PORT:

MCP_PORT=3000 npx -y resend-mcp --http

Gunakan sebagai pustaka

Transportasi HTTP juga diekspor agar dapat disematkan di layanan lain, alih-alih dijalankan melalui CLI. Setiap klien yang terhubung melakukan autentikasi dengan kunci API Resend miliknya sendiri yang diberikan sebagai token Bearer.

import { runHttp } from 'resend-mcp/http';

// Options are optional — pass `senderEmailAddress` / `replierEmailAddresses`
// to set defaults. Binds the port and returns the Node http.Server, exposing
// the MCP endpoint at POST/GET/DELETE /mcp and a GET /health check.
const server = await runHttp({}, 3000);

Secara default, server menerapkan validasi Host khusus localhost (perlindungan DNS rebinding). Saat diterapkan di balik reverse proxy atau load balancer, ketika server dilindungi oleh kunci API Bearer per permintaan, atur host ke 0.0.0.0 agar Host yang diteruskan oleh proxy dan pemeriksaan kesehatan load balancer tidak ditolak dengan 403 Invalid Host:

const server = await runHttp({}, 3000, { host: '0.0.0.0' });
// or pin specific hostnames instead of disabling validation:
const server = await runHttp({}, 3000, { allowedHosts: ['mcp.example.com'] });

Melalui CLI, pengaturan ini dipetakan ke --host / --allowed-hosts (atau MCP_HOST / MCP_ALLOWED_HOSTS).

Opsi

Anda dapat memberikan argumen tambahan untuk mengonfigurasi server lokal:

  • --key: Kunci API Resend Anda (hanya mode stdio, karena mode HTTP menggunakan token Bearer dari klien)
  • --sender: Alamat email pengirim default dari domain terverifikasi
  • --reply-to: Alamat email balasan default (dapat ditentukan beberapa kali)
  • --http: Gunakan transportasi HTTP, bukan stdio (default: stdio)
  • --port: Port HTTP saat menggunakan --http (default: 3000, atau variabel lingkungan MCP_PORT)
  • --host: Host untuk perlindungan DNS rebinding saat menggunakan --http (default: 127.0.0.1, atau MCP_HOST). Atur ke 0.0.0.0 untuk menonaktifkan validasi Host di balik proxy/load balancer.
  • --allowed-hosts: Daftar izin Host yang dipisahkan koma saat menggunakan --http (atau MCP_ALLOWED_HOSTS)
  • --allowed-file-dirs: Direktori yang dipisahkan koma tempat lampiran file lokal dan impor CSV dapat dibaca (atau MCP_ALLOWED_FILE_DIRS). Tidak dibatasi dalam stdio jika tidak diatur; selalu dinonaktifkan melalui --http kecuali diatur.

Variabel lingkungan:

  • RESEND_API_KEY: Kunci API Resend Anda (wajib untuk stdio, opsional untuk HTTP karena klien memberikannya melalui token Bearer)
  • SENDER_EMAIL_ADDRESS: Alamat email pengirim default dari domain terverifikasi (opsional)
  • REPLY_TO_EMAIL_ADDRESSES: Alamat email balasan yang dipisahkan koma (opsional)
  • MCP_PORT: Port HTTP saat menggunakan --http (opsional)
  • MCP_HOST: Host untuk perlindungan DNS rebinding saat menggunakan --http (opsional)
  • MCP_ALLOWED_HOSTS: Daftar izin Host yang dipisahkan koma saat menggunakan --http (opsional)
  • MCP_ALLOWED_FILE_DIRS: Direktori yang dipisahkan koma tempat file lokal dapat dibaca (opsional)

[!NOTE] Jika Anda tidak memberikan alamat email pengirim, server MCP akan meminta Anda untuk memberikannya setiap kali Anda memanggil alat.

[!WARNING] send-email (attachments[].filePath) dan create-contact-import (filePath) membaca file lokal. Melalui --http, fitur ini dinonaktifkan secara default agar klien jarak jauh tidak dapat membaca disk server; gunakan --allowed-file-dirs untuk mengizinkan direktori tertentu. Pada stdio, atur --allowed-file-dirs agar agen yang disusupi melalui prompt tidak dapat melampirkan file di luar folder yang Anda pilih.

Alat Server MCP

Server MCP Resend memberi agen AI Anda akses native ke seluruh platform Resend melalui satu integrasi. Anda dapat mengelola semua aspek infrastruktur email menggunakan bahasa alami.

  • Email: Kirim, daftar, ambil, batalkan, perbarui, bagikan, dan kirim email secara massal. Ambil metrik pengiriman dan interaksi. Mendukung HTML, teks biasa, lampiran (file lokal, URL, atau base64), CC/BCC, alamat balasan, penjadwalan, tag, header kustom, pengiriman berbasis topik, dan kunci idempotensi.
  • Email yang Diterima: Daftar dan baca email masuk. Daftar dan unduh lampiran email yang diterima.
  • Kotak Masuk: Buat, daftar, ambil, perbarui, dan hapus kotak masuk. Baca dan perbarui pengaturan agen kotak masuk. Daftar, cari, ambil, perbarui, dan hapus utas, serta tambahkan, tetapkan, atau hapus labelnya. Daftar dan ambil email dalam utas, serta balas atau teruskan email tersebut dengan lampiran dan header kustom. Buat, daftar, perbarui, dan hapus label. Buat, daftar, ambil, perbarui, hapus, dan kirim draf dengan lampiran dari konten base64 atau URL. Kirim email baru dari kotak masuk untuk memulai utas. Mendukung kunci idempotensi saat membalas, meneruskan, membuat draf, mengirim draf, dan mengirim email baru.
  • Templat: Buat, daftar, ambil, perbarui, publikasikan, duplikasikan, dan hapus templat email. Mendukung penyusunan konten templat dan placeholder {{{VARIABLE}}}.
  • Kontak: Buat, daftar, ambil, perbarui, dan hapus kontak. Kelola keanggotaan segmen, langganan topik, dan impor kontak CSV. Mendukung properti kontak kustom.
  • Siaran: Buat, kirim, batalkan, duplikasikan, daftar, ambil, perbarui, dan hapus kampanye siaran. Daftar tautan yang diklik dalam siaran dan penerimanya berdasarkan jenis peristiwa (terkirim, terkirim ke penerima, dibuka, diklik, terpental, dilaporkan sebagai spam, berhenti berlangganan, ditekan). Mendukung penjadwalan, placeholder personalisasi, dan teks pratinjau.
  • Otomatisasi: Buat, daftar, ambil, perbarui, duplikasikan, dan hapus otomatisasi. Tinjau proses yang dijalankan oleh otomatisasi.
  • Peristiwa: Kirim peristiwa untuk memicu otomatisasi bagi kontak. Buat, perbarui, dan hapus definisi peristiwa.
  • Domain: Buat, daftar, ambil, perbarui, hapus, dan verifikasi domain pengirim. Konfigurasikan pelacakan, TLS, serta kemampuan mengirim dan menerima. Buat dan verifikasi klaim domain.
  • Segmen: Buat, daftar, ambil, perbarui, dan hapus segmen audiens.
  • Penekanan: Daftar, ambil, tambahkan, dan hapus entri daftar penekanan, satu per satu atau secara massal. Hard bounce dan laporan spam ditekan secara otomatis; tambahkan alamat secara manual untuk memenuhi permintaan agar tidak dihubungi.
  • Topik: Buat, daftar, ambil, perbarui, dan hapus topik langganan.
  • Properti Kontak: Buat, daftar, ambil, perbarui, dan hapus atribut kontak kustom.
  • Kunci API: Buat, daftar, perbarui, dan hapus kunci API.
  • Webhook: Buat, daftar, ambil, perbarui, dan hapus webhook untuk notifikasi peristiwa, serta periksa riwayat pengirimannya — peristiwa yang dikirim ke webhook, payload suatu peristiwa, dan upaya pengirimannya. Putar ulang peristiwa untuk mengantrekan pengiriman lain, dan rotasi rahasia penandatanganan webhook.
  • Log: Daftar dan periksa log permintaan API, termasuk isi lengkap permintaan dan respons.
  • Penggunaan: Ambil informasi penggunaan dan kuota tingkat akun: email, kontak, segmen, siaran, kredit AI, proses otomatisasi, domain, dan batas laju API.
  • Editor: Hubungkan ke (dan putuskan koneksi dari) editor visual di dasbor Resend, serta baca konten draf saat berkolaborasi dalam siaran dan templat.

Pengembangan Lokal

  1. Klon proyek ini dan bangun:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. Untuk menggunakan build lokal, ganti perintah npx dengan path ke build lokal Anda:

Claude Code (stdio):

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js

Claude Code (HTTP):

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor / Claude Desktop (stdio):

{
  "mcpServers": {
    "resend": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Cursor (HTTP):

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Pengujian Langsung dengan Klien MCP

Saat mengembangkan, Anda dapat menguji perubahan dalam sesi klien MCP sungguhan sambil mengedit kode di tempat lain.

Caranya: jalankan tsc --watch untuk membangun ulang dist/ secara terus-menerus, lalu arahkan klien MCP terpisah ke dist/index.js yang telah dibangun dari direktori lain. Untuk menerapkan perubahan kode, mulai ulang sesi klien MCP (server MCP adalah proses stdio berumur panjang yang tidak memuat ulang secara otomatis).

Contoh dengan Claude Code:

  1. Jalankan pemantau TypeScript untuk membangun ulang secara otomatis setiap kali disimpan:

    pnpm tsc --watch
    
  2. Di direktori terpisah, buat .mcp.json yang mengarah ke hasil build:

    mkdir -p /tmp/mcp-test
    
    // /tmp/mcp-test/.mcp.json
    {
      "mcpServers": {
        "resend-dev": {
          "command": "node",
          "args": ["/absolute/path/to/resend-mcp/dist/index.js"],
          "env": {
            "RESEND_API_KEY": "re_xxxxxxxxx"
          }
        }
      }
    }
    
  3. Mulai Claude Code dari direktori tersebut dan gunakan alat MCP. Setelah membuat perubahan kode, mulai sesi Claude Code baru untuk menggunakan build terbaru.

Prinsip yang sama berlaku untuk klien MCP mana pun — pisahkan lingkungan pengujian dari lingkungan pengembangan, gunakan path absolut ke dist/index.js, lalu hubungkan kembali server MCP setelah membangun ulang.

Pengujian dengan MCP Inspector

Catatan: Pastikan Anda telah membangun proyek terlebih dahulu (lihat bagian Pengembangan Lokal di atas).

Menggunakan Transportasi Stdio

  1. Atur kunci API Anda:

    export RESEND_API_KEY=re_your_key_here
    
  2. Jalankan inspector:

    pnpm inspector
    
  3. Di browser (UI Inspector):

    • Pilih stdio (jalankan proses).
    • Perintah: node
    • Argumen: dist/index.js (atau jalur lengkap ke dist/index.js)
    • Env: RESEND_API_KEY=re_your_key_here (atau biarkan kosong jika Anda sudah mengekspornya di terminal yang sama).
    • Klik Connect, lalu gunakan "List tools" untuk memverifikasi bahwa server berfungsi.

Menggunakan Transport HTTP

  1. Jalankan server HTTP di satu terminal:

    node dist/index.js --http --port 3000
    
  2. Jalankan inspector di terminal lain:

    pnpm inspector
    
  3. Di browser (UI Inspector):

    • Pilih Streamable HTTP (hubungkan ke URL).
    • URL: http://127.0.0.1:3000/mcp
    • Tambahkan header khusus: Authorization: Bearer re_your_key_here dan aktifkan toggle.
    • Klik Connect, lalu gunakan "List tools" untuk memverifikasi bahwa server berfungsi.