What is Inbox Mcp

Inbox-MCP is a Model Context Protocol (MCP) server designed for email integration via Nylas. It enables AI assistants to efficiently batch-triage, organize, and automate email management through natural language interactions.

Use cases

Use cases for Inbox-MCP include summarizing important emails, filtering unimportant messages, archiving older emails, and forwarding alerts or notifications to teams.

How to use

To use Inbox-MCP, simply connect your email accounts (Gmail, Outlook, iCloud, Yahoo, or any IMAP service) and start interacting with your inbox using conversational language. The server processes requests and provides responses in easily parsable XML format.

Key features

Key features of Inbox-MCP include seamless integration with multiple email services, natural language processing for email management, batch processing capabilities, and the ability to reduce cognitive load by automating routine tasks.

Where to use

Inbox-MCP can be used in various fields including business, education, and personal productivity, where efficient email management is crucial.

Inbox MCP

Transform your inbox into an intelligent, LLM-powered assistant—instantly.

Easily manage, organize, and streamline your email using conversational language, powered by robust, batch-friendly tools built on Nylas v3. Compatible out-of-the-box with Gmail, Outlook, iCloud, Yahoo, and virtually any IMAP service (even your work email!).

Tools are carefully crafted with clear descriptions and consistent parameters optimized for seamless integration with various LLMs. Responses are provided as easily parsable XML blocks, allowing the LLM to effortlessly handle your requests.

Tested extensively in real-life workflows, Inbox MCP significantly reduces cognitive load, efficiently handling tasks you’d rather automate.

Nylas includes 5 free connected accounts, so you can get started immediately—without spending a dime.

✨ Real-life examples (things you’ll actually say)

🎯 Why use Inbox MCP?

• Inbox Zero, Simplified: Quickly automate email management using natural language instructions.
• Efficient Triage: Instantly categorize, prioritize, and batch-process emails effortlessly.
• Easy Setup: Hassle-free onboarding with direct account connections. No OAuth tokens, proxies, or complex setups.

📌 Quick Setup: Creating a Nylas Account

1. Sign up at: Nylas Dashboard.
2. Grab your API key from the sidebar (API KEY).
   
3. Navigate to Grants, click Add Test Grant (top-right), and connect your email account.
   
4. Note your API key and Grant ID (shown in the grants table).

🚀 Get started (in under a minute)

Easy Smithery Installation (Interactive)

Inbox MCP integrates seamlessly with MCP clients like Claude Desktop, Cursor, Windsurf, and more.

Interactive one-liner installation (recommended):

npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client claude

This will prompt you for your Nylas credentials (nylasAccessToken and nylasGrantId). For other supported MCP clients, replace claude with your preferred client:

npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client cursor # or windsurf, vscode, etc.

🛠️ Manual local setup (optional)

If you prefer manual control for local development:

git clone https://github.com/darinkishore/Inbox-MCP.git
cd Inbox-MCP
npm install && npm run build

Then in your MCP client’s mcp-config.json:

{
  "mcpServers": {
    "nylas-email": {
      "command": "node dist/index.js",
      "workingDirectory": "/absolute/path/to/Inbox-MCP",
      "env": {
        "NYLAS_ACCESS_TOKEN": "...",
        "NYLAS_GRANT_ID": "..."
      }
    }
  }
}

🔧 Daily workflow tools (optimized)

🗺️ Roadmap

• Enhanced provider-native search (advanced queries, multi-term searches)
• Calendar and contacts integration
• Expanded toolset and automation capabilities

👩‍💻 Developer-friendly

• Clean TypeScript (v5.2), minimal dependencies
• Robust built-in retries (exponential back-off + jitter)
• Contributions warmly welcomed—let’s make email management better together!

📄 License & Support

Licensed under MIT.

If Inbox MCP makes your day easier, please ⭐️—your star helps others discover it too!