{"_id":"@cristip73/email-mcp","name":"@cristip73/email-mcp","dist-tags":{"latest":"0.8.0"},"versions":{"0.8.0":{"name":"@cristip73/email-mcp","version":"0.8.0","description":"MCP server for Gmail operations","type":"module","main":"build/index.js","bin":{"email-mcp":"build/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","auth":"node build/index.js auth","dev":"tsc && node build/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"0.6.0","dotenv":"^16.3.1","google-auth-library":"^9.4.1","googleapis":"^129.0.0","open":"^10.0.0","quoted-printable":"^1.0.1","zod":"^3.22.4","zod-to-json-schema":"^3.22.1"},"devDependencies":{"@types/node":"^20.17.24","@types/quoted-printable":"^1.0.2","typescript":"^5.3.2"},"repository":{"type":"git","url":"git+https://github.com/cristip73/MCP-email-server.git"},"keywords":["mcp","gmail","email","claude","model-context-protocol"],"author":{"name":"cristip73"},"license":"MIT","bugs":{"url":"https://github.com/cristip73/MCP-email-server/issues"},"homepage":"https://github.com/cristip73/MCP-email-server#readme","publishConfig":{"access":"public"},"engines":{"node":">=16.0.0"},"_id":"@cristip73/email-mcp@0.8.0","gitHead":"1fbc0a1a38533965627ecd07dfe0e3e35c9becad","_nodeVersion":"23.7.0","_npmVersion":"11.1.0","dist":{"integrity":"sha512-U+o8u83rsyLEMz1Au08PclGzB71MxB4bZ61/vYmSJEei/1cdFUX9V/SE/A6XIH22aBIhT967wAsooUCSHXdIOw==","shasum":"1c7fb1ffdd80bb65e7ace60075fc043f8d98d27c","tarball":"https://registry.npmjs.org/@cristip73/email-mcp/-/email-mcp-0.8.0.tgz","fileCount":35,"unpackedSize":261866,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDU98P6glwdnG4H9pagXNdJ4Zvbu0tduGg7ebeGbE8yVAiAqdB8mLha6MhtSxuK8FJ+4e3FjtnUCCFDQfOc5PdEtCQ=="}]},"_npmUser":{"name":"cristip73","email":"cristian.panaite@gmail.com"},"directories":{},"maintainers":[{"name":"cristip73","email":"cristian.panaite@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/email-mcp_0.8.0_1743721073721_0.5184843103345698"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-03T22:57:53.666Z","0.8.0":"2025-04-03T22:57:53.976Z","modified":"2025-04-03T22:57:54.209Z"},"maintainers":[{"name":"cristip73","email":"cristian.panaite@gmail.com"}],"description":"MCP server for Gmail operations","homepage":"https://github.com/cristip73/MCP-email-server#readme","keywords":["mcp","gmail","email","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/cristip73/MCP-email-server.git"},"author":{"name":"cristip73"},"bugs":{"url":"https://github.com/cristip73/MCP-email-server/issues"},"license":"MIT","readme":"# MCP Gmail Server\n\nA Model Context Protocol (MCP) server that enables Claude Desktop App and other MCP-compatible applications to interact with Gmail. This package provides capabilities for reading, searching, and sending emails through a standardized interface.\n\n## Features\n\n- **Core Email Operations**: Send emails, replies, forwards, read and search emails\n- **Advanced Features**: Reply-all, CC/BCC, quoted replies, threading, attachments, drafts\n- **Gmail-Specific**: Category management (Primary, Social, Promotions, etc.)\n- **Label Management**: Create, modify, list, and apply Gmail labels\n- **Attachment Handling**: List and save email attachments securely\n- **Time Zone Support**: Proper date/time handling based on your local timezone\n\n## Quick Start\n\n### Installation & Authentication\n\n```bash\n# Run with npx (no installation needed)\nnpx @cristip73/email-mcp auth\n\n# This will open a browser window for Gmail authentication\n```\n\n### Configuration with Claude Desktop\n\nAdd to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"email-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@cristip73/email-mcp\"\n      ],\n      \"env\": {\n        \"TIME_ZONE\": \"GMT+2\",\n        \"DEFAULT_ATTACHMENTS_FOLDER\": \"/Users/username/CLAUDE/Attachments\"\n      }     \n    }\n  }\n}\n```\n\n## Prerequisites\n\n- Node.js 16 or higher\n- A Google Cloud project with Gmail API enabled\n- OAuth credentials for a Desktop application\n- A Gmail account\n\n## Detailed Setup\n\nFor detailed setup instructions including OAuth configuration, see [INSTALL.md](https://github.com/cristip73/MCP-email-server/blob/main/INSTALL.md).\n\n## Environment Variables\n\n- `TIME_ZONE`: Your timezone in GMT format (e.g., GMT+2)\n- `DEFAULT_ATTACHMENTS_FOLDER`: Path for saving attachments\n- `GMAIL_OAUTH_PATH`: Custom path to OAuth credentials file\n- `GMAIL_CREDENTIALS_PATH`: Custom path to tokens file\n\n## File Locations\n\nThe configuration files are stored in your home directory:\n\n- **OAuth Credentials**: `~/.email-mcp/gcp-oauth.keys.json`\n  - macOS: `/Users/[username]/.email-mcp/gcp-oauth.keys.json`\n  - Linux: `/home/[username]/.email-mcp/gcp-oauth.keys.json`\n  - Windows: `C:\\Users\\[username]\\.email-mcp\\gcp-oauth.keys.json`\n\n- **Auth Tokens**: `~/.email-mcp/credentials.json`\n  - macOS: `/Users/[username]/.email-mcp/credentials.json`\n  - Linux: `/home/[username]/.email-mcp/credentials.json`\n  - Windows: `C:\\Users\\[username]\\.email-mcp\\credentials.json`\n\nThe `.email-mcp` directory is hidden but will be created automatically.\n\n## Full Documentation\n\nFor complete documentation, available tools, and example prompts, see [the full README](https://github.com/cristip73/MCP-email-server).\n\n## License\n\nMIT ","readmeFilename":"README.md","_rev":"1-a1135a6914493108b07923721f611cba"}