{"_id":"@coretext-ai/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9","name":"@coretext-ai/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.1":{"name":"@coretext-ai/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9","version":"1.0.1","description":"MCP server with google-gmail integration","type":"module","main":"dist/index.js","bin":{"google-gmail-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","watch":"tsx --watch src/index.ts","test":"jest","lint":"eslint src/**/*.ts"},"keywords":["mcp","model-context-protocol","ai","server","google-gmail"],"author":{"name":"Coretext AI","email":"npm@coretext.ai"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"^1.6.0","dotenv":"^16.3.0","oauth":"latest","fs-extra":"^11.2.0","open":"^10.0.0","keytar":"^7.9.0","google-auth-library":"^9.0.0"},"devDependencies":{"@types/node":"^20.0.0","@typescript-eslint/eslint-plugin":"^7.0.0","@typescript-eslint/parser":"^7.0.0","eslint":"^8.42.0","jest":"^29.5.0","tsx":"^4.0.0","typescript":"^5.0.0","@types/fs-extra":"^11.0.0"},"repository":{"type":"git","url":"git+https://github.com/coretext-ai/google-gmail-mcp-server.git"},"_id":"@coretext-ai/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9@1.0.1","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/coretext-ai/google-gmail-mcp-server/issues"},"homepage":"https://github.com/coretext-ai/google-gmail-mcp-server#readme","_integrity":"sha512-6REZeDuZi3hmW1uLCMA/ua9pXQ5wJmskdAHq13uv9dz3LsXVf0DW2koNg+aALdbyn5NcuOs+xB9LSDgz0xg2xg==","_resolved":"/var/folders/s3/1sfw2l7x2691ltmzrn2bjjmm0000gn/T/npm-publish-nHstog/@coretext-ai-google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9-1.0.1.tgz","_from":"file:/var/folders/s3/1sfw2l7x2691ltmzrn2bjjmm0000gn/T/npm-publish-nHstog/@coretext-ai-google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9-1.0.1.tgz","_nodeVersion":"20.19.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-6REZeDuZi3hmW1uLCMA/ua9pXQ5wJmskdAHq13uv9dz3LsXVf0DW2koNg+aALdbyn5NcuOs+xB9LSDgz0xg2xg==","shasum":"871c1570880e6eafe1d74aad14b98537ed125489","tarball":"https://registry.npmjs.org/@coretext-ai/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9/-/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9-1.0.1.tgz","fileCount":54,"unpackedSize":542857,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIB6mKaTK0ECBBhYzh5tofvP5egxIO5gJJtUT+69FsI3mAiAJbz2vGS7CIVZAzEbANRdvucZVuLw8xQsEubDFM/KlpA=="}]},"_npmUser":{"name":"gerson-coretext","email":"gerson@coretextai.dev"},"directories":{},"maintainers":[{"name":"rugved-core","email":"rugved@coretextai.dev"},{"name":"ctxmitch","email":"mitchell@coretextai.dev"},{"name":"gerson-coretext","email":"gerson@coretextai.dev"},{"name":"dgomezcortextai","email":"daniel@coretextai.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9_1.0.1_1757513900245_0.47906229923237564"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-10T14:18:20.154Z","1.0.1":"2025-09-10T14:18:20.421Z","modified":"2025-09-10T14:18:20.737Z"},"maintainers":[{"name":"rugved-core","email":"rugved@coretextai.dev"},{"name":"ctxmitch","email":"mitchell@coretextai.dev"},{"name":"gerson-coretext","email":"gerson@coretextai.dev"},{"name":"dgomezcortextai","email":"daniel@coretextai.dev"}],"description":"MCP server with google-gmail integration","homepage":"https://github.com/coretext-ai/google-gmail-mcp-server#readme","keywords":["mcp","model-context-protocol","ai","server","google-gmail"],"repository":{"type":"git","url":"git+https://github.com/coretext-ai/google-gmail-mcp-server.git"},"author":{"name":"Coretext AI","email":"npm@coretext.ai"},"bugs":{"url":"https://github.com/coretext-ai/google-gmail-mcp-server/issues"},"license":"MIT","readme":"# google-gmail-mcp-server\n\nMCP server with google-gmail integration\n\nThis MCP server was generated using the Template Orchestrator and includes the following integrations:\n\n## Available Tools\n\nThis MCP server provides 25 tools across 1 integrations:\n\n### GoogleGmail Tools\n- **google-gmail_send_message**: Send an email message. Requires message in RFC 2822 format encoded as base64url string\n- **google-gmail_get_message**: Get a specific message by ID\n- **google-gmail_list_messages**: List messages in user's mailbox with optional filtering\n- **google-gmail_modify_message**: Modify labels on a message (add/remove labels, mark read/unread)\n- **google-gmail_trash_message**: Move a message to trash (RECOMMENDED for deleting emails). This is the standard way users delete emails - messages remain recoverable for 30 days.\n- **google-gmail_untrash_message**: Remove a message from trash\n- **google-gmail_delete_message**: PERMANENTLY delete a message - IMMEDIATE and IRREVERSIBLE. WARNING: Use trash_message instead for normal email deletion. Only use this for sensitive data that must be immediately destroyed. Bypasses trash completely. REQUIRES https://mail.google.com/ scope. Returns 204 No Content with empty body on success.\n- **google-gmail_list_labels**: List all labels in the user's mailbox\n- **google-gmail_get_label**: Get label details by ID\n- **google-gmail_create_label**: Create a new custom label\n- **google-gmail_update_label**: Update an existing label\n- **google-gmail_delete_label**: Delete a custom label. Returns 204 No Content with empty body on success.\n- **google-gmail_list_threads**: List email threads in user's mailbox\n- **google-gmail_get_thread**: Get a specific thread by ID\n- **google-gmail_modify_thread**: Modify labels on all messages in a thread\n- **google-gmail_trash_thread**: Move an entire email thread/conversation to trash (RECOMMENDED for deleting conversations). This is the standard way users delete email threads - remains recoverable for 30 days.\n- **google-gmail_untrash_thread**: Remove a thread from trash\n- **google-gmail_delete_thread**: PERMANENTLY delete an entire thread - IMMEDIATE and IRREVERSIBLE. WARNING: Use trash_thread instead for normal conversation deletion. Only use this for sensitive data that must be immediately destroyed. Bypasses trash completely. REQUIRES https://mail.google.com/ scope. Returns 204 No Content with empty body on success.\n- **google-gmail_list_drafts**: List draft messages in user's mailbox\n- **google-gmail_get_draft**: Get a specific draft by ID\n- **google-gmail_create_draft**: Create a new draft message. IMPORTANT: Message must be an object with 'raw' field containing base64url-encoded RFC 2822 formatted message.\n- **google-gmail_update_draft**: Update an existing draft. IMPORTANT: Message must be an object with 'raw' field containing base64url-encoded RFC 2822 formatted message.\n- **google-gmail_send_draft**: Send an existing draft\n- **google-gmail_delete_draft**: Delete a draft. Returns 204 No Content with empty body on success.\n- **google-gmail_get_profile**: Get user's Gmail profile information\n\n## Installation\n\n```bash\nnpm install @coretext-ai/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9\n```\n\n## Environment Setup\n\nCreate a `.env` file with the following variables:\n\n```env\nGITHUB_TOKEN=your_github_token_here\nGOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here\n```\n\n## Usage\n\n### Running the server\n\n```bash\n# Development mode\nnpm run dev\n\n# Production mode\nnpm run build && npm start\n```\n\n### Using with Claude Desktop\n\nAdd this to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-gmail-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coretext-ai/google-gmail-mcp-server-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9\"],\n      \"env\": {\n        \"GITHUB_TOKEN\": \"your_github_token_here\",\n        \"GOOGLE_OAUTH_CREDENTIALS\": \"your_google_oauth_credentials_here\"\n      }\n    }\n  }\n}\n```\n\n## Instructions for Fetching API Keys/Tokens\n- **COMING SOON**\n\n## Advanced Features\n\n### Request Cancellation\n\nThis MCP server supports request cancellation according to the [MCP cancellation specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/cancellation). Clients can cancel in-progress requests by sending a `notifications/cancelled` message with the request ID.\n\nWhen a request is cancelled:\n- The server immediately stops processing the request\n- Any ongoing API calls are aborted\n- Resources are cleaned up\n- No response is sent for the cancelled request\n\n### Progress Notifications\n\nThe server supports progress notifications for long-running operations according to the [MCP progress specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/progress). \n\nTo receive progress updates:\n1. Include a `progressToken` in your request metadata\n2. The server will send `notifications/progress` messages with:\n   - Current progress value\n   - Total value (when known)\n   - Human-readable status messages\n\nProgress is reported for:\n- Multi-step operations\n- Batch processing\n- Long-running API calls\n- File uploads/downloads\n\nExample progress notification:\n```json\n{\n  \"method\": \"notifications/progress\",\n  \"params\": {\n    \"progressToken\": \"operation-123\",\n    \"progress\": 45,\n    \"total\": 100,\n    \"message\": \"Processing item 45 of 100...\"\n  }\n}\n```\n\n## Generated Information\n\n- **Generated at**: Wed Sep 10 2025 10:17:48 GMT-0400 (Eastern Daylight Time)\n- **Orchestrator version**: 0.0.2\n- **Template repository**: Coretext-AI-Dev/server-template-v2\n- **Total endpoints**: 25\n","readmeFilename":"README.md","_rev":"1-0f036e75dbd12fb4fd3bc9d347213fc4"}