Forward Email MCP Server

Forward Email MCP Server

TL;DR: Vår åpne kildekode MCP-server lar AI-assistenter som Claude, ChatGPT, Cursor og Windsurf administrere e-post, domener, aliaser, kontakter og kalendere gjennom naturlig språk. Alle 68 API-endepunkter er eksponert som MCP-verktøy. Den kjører lokalt via npx @forwardemail/mcp-server — dine legitimasjoner forlater aldri maskinen din.

Hva er MCP?

Model Context Protocol (MCP) er en åpen standard laget av Anthropic som lar AI-modeller sikkert kalle eksterne verktøy. I stedet for å kopiere og lime inn API-svar i et chat-vindu, gir MCP modellen direkte, strukturert tilgang til tjenestene dine.

Vår MCP-server pakker inn hele Forward Email API — hvert endepunkt, hver parameter — og eksponerer dem som verktøy som enhver MCP-kompatibel klient kan bruke. Serveren kjører lokalt på maskinen din ved bruk av stdio-transport. Dine legitimasjoner forblir i miljøvariablene dine og sendes aldri til AI-modellen.

Rask start

Få en API-nøkkel

  1. Logg inn på din Forward Email-konto.
  2. Gå til Min konto → Sikkerhet → API-nøkler.
  3. Generer en ny API-nøkkel og kopier den.

Claude Desktop

Legg dette til i din Claude Desktop konfigurasjonsfil:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "forwardemail": {
      "command": "npx",
      "args": ["-y", "@forwardemail/mcp-server"],
      "env": {
        "FORWARD_EMAIL_API_KEY": "your-api-key-here",
        "FORWARD_EMAIL_ALIAS_USER": "you@example.com",
        "FORWARD_EMAIL_ALIAS_PASSWORD": "your-generated-alias-password"
      }
    }
  }
}

Start Claude Desktop på nytt. Du skal nå se Forward Email-verktøyene i verktøysvelgeren.

Merk: Variablene FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD er valgfrie, men kreves for postkasseverktøy (meldinger, mapper, kontakter, kalendere). Se Autentisering for detaljer.

Cursor

Åpne Cursor-innstillinger → MCP → Legg til server:

{
  "mcpServers": {
    "forwardemail": {
      "command": "npx",
      "args": ["-y", "@forwardemail/mcp-server"],
      "env": {
        "FORWARD_EMAIL_API_KEY": "your-api-key-here",
        "FORWARD_EMAIL_ALIAS_USER": "you@example.com",
        "FORWARD_EMAIL_ALIAS_PASSWORD": "your-generated-alias-password"
      }
    }
  }
}

Windsurf

Åpne Windsurf-innstillinger → MCP → Legg til server med samme konfigurasjon som ovenfor.

Andre MCP-klienter

Enhver klient som støtter MCP stdio-transport vil fungere. Kommandoen er:

FORWARD_EMAIL_API_KEY=your-api-key \
  FORWARD_EMAIL_ALIAS_USER=you@example.com \
  FORWARD_EMAIL_ALIAS_PASSWORD=your-generated-alias-password \
  npx @forwardemail/mcp-server

Autentisering

Forward Email API bruker HTTP Basic autentisering med to forskjellige legitimasjonstyper avhengig av endepunktet. MCP-serveren håndterer dette automatisk — du trenger bare å oppgi riktige legitimasjoner.

API-nøkkel-autentisering

De fleste administrasjonsendepunkter (domener, aliaser, utgående e-poster, logger) bruker din API-nøkkel som Basic auth-brukernavn med et tomt passord.

Dette er samme API-nøkkel som du bruker for REST API-et. Sett den via miljøvariabelen FORWARD_EMAIL_API_KEY.

Alias-autentisering

Postkasseendepunkter (meldinger, mapper, kontakter, kalendere, alias-avgrensede sieve-skript) bruker alias-legitimasjon — alias-e-postadressen som brukernavn og et generert passord som passord.

Disse endepunktene får tilgang til data per alias via IMAP, CalDAV og CardDAV-protokoller. De krever alias-e-post og et generert passord, ikke API-nøkkelen.

Du kan oppgi alias-legitimasjon på to måter:

  1. Miljøvariabler (anbefalt for standard alias): Sett FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD.
  2. Parametere per verktøysanrop: Send alias_username og alias_password som argumenter til ethvert alias-autentiseringsverktøy. Disse overstyrer miljøvariablene, noe som er nyttig når du arbeider med flere aliaser.

Generere et alias-passord

Før du kan bruke alias-autentiseringsverktøy, må du generere et passord for aliaset. Du kan gjøre dette med verktøyet generateAliasPassword eller via API:

curl -u "YOUR_API_KEY:" \
  https://api.forwardemail.net/v1/domains/example.com/aliases/ALIAS_ID/generate-password \
  -X POST

Responsen inkluderer feltene username (alias-e-post) og password. Bruk disse som dine alias-legitimasjoner.

Tips: Du kan også spørre din AI-assistent: "Generate a password for the alias user@example.com on domain example.com" — den vil kalle generateAliasPassword-verktøyet og returnere legitimasjonene.

Tabellen nedenfor oppsummerer hvilken autentiseringsmetode hver verktøygruppe krever:

Verktøygruppe Autentiseringsmetode Legitimasjoner
Konto API-nøkkel eller Alias-autentisering Begge deler
Domener, aliaser, domenemedlemmer, invitasjoner, Catch-All-passord API-nøkkel FORWARD_EMAIL_API_KEY
Utgående e-poster (liste, hent, slett, begrens) API-nøkkel FORWARD_EMAIL_API_KEY
Send e-post API-nøkkel eller Alias-autentisering Begge deler
Meldinger (IMAP) Alias-autentisering FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD
Mapper (IMAP) Alias-autentisering FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD
Kontakter (CardDAV) Alias-autentisering FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD
Kalendere (CalDAV) Alias-autentisering FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD
Kalenderhendelser (CalDAV) Alias-autentisering FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD
Sieve-skript (domene-avgrenset) API-nøkkel FORWARD_EMAIL_API_KEY
Sieve-skript (alias-avgrenset) Alias-autentisering FORWARD_EMAIL_ALIAS_USER + FORWARD_EMAIL_ALIAS_PASSWORD
Logger API-nøkkel FORWARD_EMAIL_API_KEY
Krypter Ingen Ingen legitimasjon nødvendig

Alle 68 verktøy

Hvert verktøy kobles direkte til et Forward Email API endepunkt. Parametere bruker de samme navnene som i API-dokumentasjonen. Autentiseringsmetoden er angitt i hver seksjonstittel.

Konto (API-nøkkel eller Alias-autentisering)

Med API-nøkkel-autentisering returnerer disse brukerens kontoinformasjon. Med alias-autentisering returneres alias-/postboksinformasjon inkludert lagringskvote og innstillinger.

Verktøy API-endepunkt Beskrivelse
getAccount GET /v1/account Hent kontoinformasjonen din
updateAccount PUT /v1/account Oppdater kontoinnstillingene dine

Domener (API-nøkkel)

Verktøy API-endepunkt Beskrivelse
listDomains GET /v1/domains List opp alle domenene dine
createDomain POST /v1/domains Legg til et nytt domene
getDomain GET /v1/domains/:domain_id Hent domenedetaljer
updateDomain PUT /v1/domains/:domain_id Oppdater domeninnstillinger
deleteDomain DELETE /v1/domains/:domain_id Fjern et domene
verifyDomainRecords GET /v1/domains/:domain_id/verify-records Verifiser DNS-poster
verifySmtpRecords GET /v1/domains/:domain_id/verify-smtp Verifiser SMTP-konfigurasjon
testS3Connection POST /v1/domains/:domain_id/test-s3-connection Test egendefinert S3-lagring

Alias (API-nøkkel)

Verktøy API-endepunkt Beskrivelse
listAliases GET /v1/domains/:domain_id/aliases List aliaser for et domene
createAlias POST /v1/domains/:domain_id/aliases Opprett et nytt alias
getAlias GET /v1/domains/:domain_id/aliases/:alias_id Hent aliasdetaljer
updateAlias PUT /v1/domains/:domain_id/aliases/:alias_id Oppdater et alias
deleteAlias DELETE /v1/domains/:domain_id/aliases/:alias_id Slett et alias
generateAliasPassword POST /v1/domains/:domain_id/aliases/:alias_id/generate-password Generer IMAP/SMTP-passord for alias-autentisering

E-poster — Utgående SMTP (API-nøkkel; Send støtter begge)

Verktøy API-endepunkt Autentisering Beskrivelse
sendEmail POST /v1/emails API-nøkkel eller Alias-autentisering Send en e-post via SMTP
listEmails GET /v1/emails API-nøkkel List utgående e-poster
getEmail GET /v1/emails/:id API-nøkkel Hent e-postdetaljer og status
deleteEmail DELETE /v1/emails/:id API-nøkkel Slett en e-post i kø
getEmailLimit GET /v1/emails/limit API-nøkkel Sjekk din sendegrense

sendEmail-verktøyet godtar from, to, cc, bcc, subject, text, html og attachments. Dette er det samme som POST /v1/emails-endepunktet.

Meldinger — IMAP (Alias-autentisering)

Krever alias-legitimasjon. Send med alias_username og alias_password eller sett miljøvariablene FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD. | Verktøy | API-endepunkt | Beskrivelse | | --------------- | ------------------------- | ----------------------------------- | | listMessages | GET /v1/messages | List og søk i meldinger i en postkasse | | createMessage | POST /v1/messages | Opprett et utkast eller last opp en melding | | getMessage | GET /v1/messages/:id | Hent en melding etter ID | | updateMessage | PUT /v1/messages/:id | Oppdater flagg (lest, stjernemarkert, osv.) | | deleteMessage | DELETE /v1/messages/:id | Slett en melding |

listMessages-verktøyet støtter 15+ søkeparametere inkludert subject, from, to, text, since, before, is_unread og has_attachment. Se API docs for fullstendig liste.

Mapper — IMAP (Alias Auth)

Krever alias-legitimasjon. Send med alias_username og alias_password eller sett miljøvariablene FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD.

Verktøy API-endepunkt Beskrivelse
listFolders GET /v1/folders List alle postkassemapper
createFolder POST /v1/folders Opprett en ny mappe
getFolder GET /v1/folders/:id Hent mappedetaljer
updateFolder PUT /v1/folders/:id Gi nytt navn til en mappe
deleteFolder DELETE /v1/folders/:id Slett en mappe

Kontakter — CardDAV (Alias Auth)

Krever alias-legitimasjon. Send med alias_username og alias_password eller sett miljøvariablene FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD.

Verktøy API-endepunkt Beskrivelse
listContacts GET /v1/contacts List alle kontakter
createContact POST /v1/contacts Opprett en ny kontakt
getContact GET /v1/contacts/:id Hent kontaktinformasjon
updateContact PUT /v1/contacts/:id Oppdater en kontakt
deleteContact DELETE /v1/contacts/:id Slett en kontakt

Kalendere — CalDAV (Alias Auth)

Krever alias-legitimasjon. Send med alias_username og alias_password eller sett miljøvariablene FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD.

Verktøy API-endepunkt Beskrivelse
listCalendars GET /v1/calendars List alle kalendere
createCalendar POST /v1/calendars Opprett en ny kalender
getCalendar GET /v1/calendars/:id Hent kalenderdetaljer
updateCalendar PUT /v1/calendars/:id Oppdater en kalender
deleteCalendar DELETE /v1/calendars/:id Slett en kalender

Kalenderhendelser — CalDAV (Alias Auth)

Krever alias-legitimasjon. Send med alias_username og alias_password eller sett miljøvariablene FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD.

Verktøy API-endepunkt Beskrivelse
listCalendarEvents GET /v1/calendar-events List alle hendelser
createCalendarEvent POST /v1/calendar-events Opprett en ny hendelse
getCalendarEvent GET /v1/calendar-events/:id Hent hendelsesdetaljer
updateCalendarEvent PUT /v1/calendar-events/:id Oppdater en hendelse
deleteCalendarEvent DELETE /v1/calendar-events/:id Slett en hendelse

Sieve-skript (API-nøkkel)

Disse bruker domenespesifikke stier og autentiserer med din API-nøkkel.

Verktøy API-endepunkt Beskrivelse
listSieveScripts GET /v1/domains/:domain_id/aliases/:alias_id/sieve List skript for et alias
createSieveScript POST /v1/domains/:domain_id/aliases/:alias_id/sieve Opprett et nytt skript
getSieveScript GET /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id Hent skriptdetaljer
updateSieveScript PUT /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id Oppdater et skript
deleteSieveScript DELETE /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id Slett et skript
activateSieveScript POST /v1/domains/:domain_id/aliases/:alias_id/sieve/:script_id/activate Aktiver et skript

Sieve-skript (Alias-autentisering)

Disse bruker alias-nivå autentisering. Nyttig for automatisering per alias uten å trenge API-nøkkelen.

Krever alias-legitimasjon. Send alias_username og alias_password eller sett miljøvariablene FORWARD_EMAIL_ALIAS_USER og FORWARD_EMAIL_ALIAS_PASSWORD.

Verktøy API-endepunkt Beskrivelse
listSieveScriptsAliasAuth GET /v1/sieve-scripts List opp skript
createSieveScriptAliasAuth POST /v1/sieve-scripts Opprett et skript
getSieveScriptAliasAuth GET /v1/sieve-scripts/:script_id Hent skriptdetaljer
updateSieveScriptAliasAuth PUT /v1/sieve-scripts/:script_id Oppdater et skript
deleteSieveScriptAliasAuth DELETE /v1/sieve-scripts/:script_id Slett et skript
activateSieveScriptAliasAuth POST /v1/sieve-scripts/:script_id/activate Aktiver et skript

Domenemedlemmer og invitasjoner (API-nøkkel)

Verktøy API-endepunkt Beskrivelse
updateDomainMember PUT /v1/domains/:domain_id/members/:member_id Endre en medlems rolle
removeDomainMember DELETE /v1/domains/:domain_id/members/:member_id Fjern et medlem
acceptDomainInvite GET /v1/domains/:domain_id/invites Aksepter en ventende invitasjon
createDomainInvite POST /v1/domains/:domain_id/invites Inviter noen til et domene
removeDomainInvite DELETE /v1/domains/:domain_id/invites Tilbakekall en invitasjon

Catch-All-passord (API-nøkkel)

Verktøy API-endepunkt Beskrivelse
listCatchAllPasswords GET /v1/domains/:domain_id/catch-all-passwords List opp catch-all-passord
createCatchAllPassword POST /v1/domains/:domain_id/catch-all-passwords Opprett et catch-all-passord
deleteCatchAllPassword DELETE /v1/domains/:domain_id/catch-all-passwords/:token_id Slett et catch-all-passord

Logger (API-nøkkel)

Verktøy API-endepunkt Beskrivelse
downloadLogs GET /v1/logs/download Last ned e-postleveringslogger

Krypter (Ingen autentisering)

Verktøy API-endepunkt Beskrivelse
encryptRecord POST /v1/encrypt Krypter en DNS TXT-post

Dette verktøyet krever ikke autentisering. Det krypterer videresendingsposter som forward-email=user@example.com for bruk i DNS TXT-poster.

20 praktiske bruksområder

Her er praktiske måter å bruke MCP-serveren med din AI-assistent:

1. E-postsortering

Be AI-en din om å skanne innboksen og oppsummere uleste meldinger. Den kan merke viktige e-poster, kategorisere etter avsender og utarbeide svar — alt gjennom naturlig språk. (Krever alias-legitimasjon for tilgang til innboksen.)

2. Automatisering av domeneoppsett

Setter du opp et nytt domene? Be AI-en opprette domenet, legge til aliasene dine, verifisere DNS-poster og teste SMTP-konfigurasjonen. Det som vanligvis tar 10 minutter med klikk i dashbordet blir til én samtale.

3. Massehåndtering av aliaser

Trenger du å opprette 20 aliaser for et nytt prosjekt? Beskriv hva du trenger, og la AI-en ta seg av det repetitive arbeidet. Den kan opprette aliaser, sette videresendingsregler og generere passord i én operasjon.

4. E-postkampanjeovervåking

Be AI-en din om å sjekke sendegrenser, liste opp nylige utgående e-poster, og rapportere om leveringsstatus. Nyttig for å overvåke helsen til transaksjonelle e-poster.

5. Kontakt-synkronisering og opprydding

Bruk CardDAV-verktøyene for å liste alle kontakter, finne duplikater, oppdatere utdatert informasjon, eller masseopprette kontakter fra et regneark du limer inn i chatten. (Krever alias-legitimasjon.)

6. Kalenderhåndtering

Opprett kalendere, legg til hendelser, oppdater møtetider, og slett avlyste hendelser — alt gjennom samtale. CalDAV-verktøyene støtter full CRUD på både kalendere og hendelser. (Krever alias-legitimasjon.)

7. Sieve-skriptautomatisering

Sieve-skript er kraftige, men syntaksen er kryptisk. Be AI-en din om å skrive Sieve-skript for deg: "Filtrer alle e-poster fra billing@example.com til en Faktura-mappe" blir et fungerende skript uten å måtte berøre RFC 5228-spesifikasjonen.

8. Team-innføring

Når et nytt teammedlem blir med, be AI-en om å opprette aliaset deres, generere et passord, sende dem en velkomst-e-post med legitimasjonen, og legge dem til som domenemedlem. Ett prompt, fire API-kall.

9. Sikkerhetsrevisjon

Be AI-en din om å liste alle domener, sjekke DNS-verifiseringsstatus, gjennomgå alias-konfigurasjoner, og identifisere domener med uverifiserte oppføringer. En rask sikkerhetssjekk på naturlig språk.

10. Oppsett av e-postvideresending

Setter du opp e-postvideresending for et nytt domene? Be AI-en om å opprette domenet, legge til videresendingsaliaser, kryptere DNS-oppføringene, og verifisere at alt er riktig konfigurert.

11. Innboks-søk og analyse

Bruk meldingssøkverktøyene for å finne spesifikke e-poster: "Finn alle e-poster fra john@example.com de siste 30 dagene som har vedlegg." De 15+ søkeparametrene gjør dette kraftig. (Krever alias-legitimasjon.)

12. Mappeorganisering

Be AI-en din om å opprette en mappestruktur for et nytt prosjekt, flytte meldinger mellom mapper, eller rydde opp i gamle mapper du ikke lenger trenger. (Krever alias-legitimasjon.)

13. Passordrotasjon

Generer nye alias-passord etter en tidsplan. Be AI-en om å generere et nytt passord for hvert alias og rapportere de nye legitimasjonene.

14. Kryptering av DNS-oppføringer

Krypter videresendingsoppføringene dine før du legger dem til i DNS. encryptRecord-verktøyet håndterer dette uten autentisering — nyttig for raske engangskrypteringer.

15. Analyse av leveringslogger

Last ned e-postleveringsloggene dine og be AI-en om å analysere avvisningsrater, identifisere problematiske mottakere, eller spore leveringstider.

16. Håndtering av flere domener

Hvis du administrerer flere domener, be AI-en om å gi deg en statusrapport: hvilke domener som er verifisert, hvilke som har problemer, hvor mange aliaser hvert har, og hvordan sendegrensene ser ut.

17. Catch-all-konfigurasjon

Sett opp catch-all-passord for domener som må motta e-post på hvilken som helst adresse. AI-en kan opprette, liste og administrere disse passordene for deg.

18. Administrasjon av domeninvitasjoner

Inviter teammedlemmer til å administrere domener, sjekk ventende invitasjoner, og rydd opp i utløpte. Nyttig for organisasjoner med flere domenadministratorer.

19. Testing av S3-lagring

Hvis du bruker tilpasset S3-lagring for e-postsikkerhetskopier, be AI-en om å teste tilkoblingen og verifisere at den fungerer korrekt.

20. Komposisjon av e-postutkast

Opprett e-postutkast i postboksen din uten å sende dem. Nyttig for å forberede e-poster som trenger gjennomgang før sending, eller for å bygge e-postmaler. (Krever alias-legitimasjon.)

Eksempel-prompt

Her er prompt du kan bruke direkte med AI-assistenten din:

Sende e-post:

"Send en e-post fra hello@mydomain.com til john@example.com med emnet 'Møte i morgen' og innholdet 'Hei John, er vi fortsatt på for kl. 14?'" Domeneadministrasjon:

"List opp alle mine domener og fortell meg hvilke som har uverifiserte DNS-poster."

Aliasopprettelse:

"Opprett et nytt alias support@mydomain.com som videresender til min personlige e-post."

Innboks-søk (krever alias-legitimasjon):

"Finn alle uleste e-poster fra siste uke som nevner 'faktura'."

Kalender (krever alias-legitimasjon):

"Opprett en kalender kalt 'Arbeid' og legg til et møte i morgen kl. 14:00 kalt 'Team Standup'."

Sieve-skript:

"Skriv et Sieve-skript for info@mydomain.com som automatisk svarer på e-poster med 'Takk for at du tok kontakt, vi svarer innen 24 timer.'"

Masseoperasjoner:

"Opprett aliaser for sales@, support@, billing@, og info@ på mydomain.com, alle som videresender til team@mydomain.com."

Sikkerhetssjekk:

"Sjekk DNS- og SMTP-verifiseringsstatus for alle mine domener og fortell meg om noe trenger oppmerksomhet."

Generer alias-passord:

"Generer et passord for aliaset user@example.com slik at jeg kan få tilgang til innboksen min."

Environment Variables

Variable Required Default Description
FORWARD_EMAIL_API_KEY Ja — Din Forward Email API-nøkkel (brukes som Basic auth-brukernavn for API-nøkkel-endepunkter)
FORWARD_EMAIL_ALIAS_USER Nei — Alias e-postadresse for postkasse-endepunkter (f.eks. user@example.com)
FORWARD_EMAIL_ALIAS_PASSWORD Nei — Generert alias-passord for postkasse-endepunkter
FORWARD_EMAIL_API_URL Nei https://api.forwardemail.net API-basert URL (for selvhostet eller testing)

Security

MCP-serveren kjører lokalt på maskinen din. Slik fungerer sikkerheten:

  • Dine legitimasjoner forblir lokale. Både API-nøkkelen din og alias-legitimasjonene leses fra miljøvariabler og brukes til å autentisere API-forespørsler via HTTP Basic auth. De sendes aldri til AI-modellen.
  • stdio-transport. Serveren kommuniserer med AI-klienten over stdin/stdout. Ingen nettverksporter åpnes.
  • Ingen datalagring. Serveren er stateless. Den cacher, logger eller lagrer ingen av e-postdataene dine.
  • Open source. Hele kodebasen ligger på GitHub. Du kan revidere hver linje.

Programmatic Usage

Du kan også bruke serveren som et bibliotek:

const { McpServer } = require('@forwardemail/mcp-server');

const server = new McpServer({
  apiKey: 'your-api-key',
  aliasUser: 'user@example.com',
  aliasPassword: 'generated-alias-password',
});

server.listen();

Open Source

Forward Email MCP Server er open-source på GitHub under BUSL-1.1-lisensen. Vi tror på åpenhet. Hvis du finner en feil eller ønsker en funksjon, åpne en issue.