LABSCO SUMMARY
Inbox zero as a conversation instead of an afternoon.
The batch shape is the point: one instruction can review a hundred messages, decide which ones need you, and file the rest — the same work you would otherwise do one click at a time.
What it is
An email layer built on Nylas v3, so one connection covers Gmail, Outlook, iCloud, Yahoo and most IMAP accounts including work mail. The tools take batches rather than single messages, and answers come back as parsable blocks the model can act on.
What you get
filter_emails— find mail by folder, unread state, date range or flagstriage_update_emails— batch mark read or unread, star or unstar, and move between foldersbatch_archive_emails— archive whole groups in one passsearch_emails— keyword search across the mailboxread_emails— full messages formatted as Markdown, which is what makes summarising them worksend_emailanddraft_email— send now, or leave it in drafts for you to check- Folder management — list, create, update, delete, and get-or-create
Requirements
A Nylas account with a grant for the mailbox: NYLAS_ACCESS_TOKEN and NYLAS_GRANT_ID, both taken from the Nylas dashboard after you connect the account under Grants. Nylas includes 5 free connected accounts. Install interactively through Smithery, or clone the repository, run npm install && npm run build, and point your client at node dist/index.js. Retries with exponential back-off and jitter are built in.
Setup effort
One command plus a key — npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client claude, then supply credentials
USE CASES
01
Working out what actually needs you today
Filter the recent unread mail, read the bodies as Markdown, and get back a short list of what is actionable and what is noise.
02
Clearing out low-priority mail in bulk
Find the messages that match, then move or archive the whole set in one batch update rather than message by message.
03
Archiving everything old but keeping the starred ones
Filter on date range and flags together so the batch archive skips the mail you deliberately marked.
04
Summarising a thread and passing it on
Search for the thread, read the messages in full, and send or draft a summary to whoever needs it next.
05
Setting up a filing structure
Create the folders you want, then move matching mail into them — get-or-create means re-running the same instruction is safe.
12 tools
Listed in project code.
triage_update_emails
Batch triage update: flags + folder moves in one call.
batch_archive_emails
Moves messages to the Archive folder (Gmail) or equivalent.
search_emails
Search emails. Only single-word queries are allowed; use pagetoken to paginate.
read_emails
Retrieves the full content and metadata of specific emails by their IDs.
send_email
Composes and sends a new email immediately.
draft_email
Creates a new email draft without sending it.
list_folders
Retrieves all available email folders (previously called labels).
create_folder
Creates a new email folder.
update_folder
Updates an existing folder's name.
delete_folder
Deletes a user-created email folder.
get_or_create_folder
Finds a folder by name, or creates a new one if no match is found.
BEFORE YOU INSTALL
What to know first
Tools you get
12 tools registered in the project's code.
Requires
- NYLAS_ACCESS_TOKEN in your environment
- NYLAS_GRANT_ID in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client claudeMCP Clients
Claude Desktop
CLAUDE DESKTOP · TERMINAL
npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client claudeThe Smithery install asks for your Nylas credentials (nylasAccessToken and nylasGrantId) — the API key and grant ID from your Nylas dashboard. If you build it yourself instead, put them in your client's MCP config as NYLAS_ACCESS_TOKEN and NYLAS_GRANT_ID in the server's env block.
Cursor
CURSOR · TERMINAL
npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client cursorThe Smithery install asks for your Nylas credentials (nylasAccessToken and nylasGrantId) — the API key and grant ID from your Nylas dashboard. If you build it yourself instead, put them in your client's MCP config as NYLAS_ACCESS_TOKEN and NYLAS_GRANT_ID in the server's env block.
Windsurf
WINDSURF · TERMINAL
npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client windsurfThe Smithery install asks for your Nylas credentials (nylasAccessToken and nylasGrantId) — the API key and grant ID from your Nylas dashboard. If you build it yourself instead, put them in your client's MCP config as NYLAS_ACCESS_TOKEN and NYLAS_GRANT_ID in the server's env block.
VS Code
VS CODE · TERMINAL
npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client vscodeThe Smithery install asks for your Nylas credentials (nylasAccessToken and nylasGrantId) — the API key and grant ID from your Nylas dashboard. If you build it yourself instead, put them in your client's MCP config as NYLAS_ACCESS_TOKEN and NYLAS_GRANT_ID in the server's env block.
