Skip to main content

​
MCP Tools

email-connector exposes 9 tools to Claude via the MCP protocol. Claude uses them automatically when you ask email-related questions.

​
get_recent_emails

Fetch recent emails from your inbox or a specific folder. Parameters
ParameterTypeDefaultDescription
folderstringINBOXMailbox folder name
limitnumber10Max number of emails to return
unread_onlybooleanfalseReturn only unread messages
Example prompts 
What are my most recent unread emails?

Show me the last 20 emails in my Promotions folder

​
search_emails

Search emails by sender, subject, date range, or free-text query. Parameters
ParameterTypeDescription
querystringFree-text search term
fromstringFilter by sender email address
subjectstringFilter by subject keyword
sincestringISO 8601 date — messages after this date
beforestringISO 8601 date — messages before this date
limitnumberMax results (default: 10)
Example prompts 
Find every email from Amazon in the last 3 months

Search for emails with "invoice" in the subject since January

Who has emailed me most that I never replied to?

​
get_email

Get the full content of a specific email by UID. Parameters
ParameterTypeDescription
uidnumberMessage UID
folderstringFolder containing the message (default: INBOX)
Example prompts 
Show me the full text of that last email

Read the email from my manager about the project update

​
list_mailboxes

List all mailbox folders for the connected account. Parameters None. Example prompts 
What folders do I have in my email?

List all my email labels

​
list_providers

List all supported email providers and their IMAP/SMTP settings. Parameters None. Returns Provider configurations including server hostnames, ports, and TLS settings for iCloud, Outlook, Yahoo, Fastmail, ProtonMail, and Generic IMAP.

​
draft_email

Compose a draft email without sending it. Saves to the Drafts folder. Parameters
ParameterTypeDescription
tostringRecipient email address
subjectstringEmail subject line
bodystringEmail body text
reply_to_uidnumberUID of email to reply to (optional)
Example prompts 
Draft a professional reply to the last email from my boss

Write a draft email to sarah@example.com about Thursday's meeting

​
send_email

Send a composed email via SMTP. Parameters
ParameterTypeDescription
tostringRecipient email address
subjectstringEmail subject line
bodystringEmail body text
ccstringCC recipients (comma-separated, optional)
bccstringBCC recipients (comma-separated, optional)
Example prompts 
Send that draft to john@example.com

Reply to Sarah's last email and tell her I'm available Thursday

​
mark_as_read

Mark a message as read. Parameters
ParameterTypeDescription
uidnumberMessage UID
folderstringFolder containing the message (default: INBOX)
Example prompts 
Mark that email as read

Mark all the newsletter emails as read

​
move_email

Move a message to a different folder. Parameters
ParameterTypeDescription
uidnumberMessage UID
destinationstringTarget folder name
Example prompts 
Move that email to my Archive folder

File the receipt from Amazon in my Shopping folder