GMail Manager MCP

# 📋 Changelog All notable changes to **Gmail Manager MCP** will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). --- ## [1.7.4](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.7.3...v1.7.4) (2025-09-12) ### Bug Fixes * include public directory in npm package ([0f2a8b1](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/0f2a8b17dc929ea9c98814037bb3b4b6ee1830b6)) ## [1.7.3](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.7.2...v1.7.3) (2025-09-12) ### Bug Fixes * support desktop OAuth clients in auth command ([6892b22](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/6892b22a8a4118b65e6657b0aab4828d5aaeff95)) ## [1.7.2](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.7.1...v1.7.2) (2025-09-12) ### Bug Fixes * remove circular dependency causing path resolution error ([eed0471](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/eed0471ad099f6c4db7bb3fe891f11a2e44ec0bc)) ## [1.7.1](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.7.0...v1.7.1) (2025-09-12) ### Bug Fixes * improve badge formatting with darker colors and inline emojis ([9448665](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/9448665364cca17e63e80a9964f287dbce0bfd67)) # [1.7.0](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.6.0...v1.7.0) (2025-09-11) ### Bug Fixes * improve badge formatting with darker colors and inline emojis ([ab7d906](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/ab7d90612201973e48fb8a134970277d30cacc45)) * improve badge formatting with darker colors and inline emojis ([bc3ffa0](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/bc3ffa0abd1128b60c8f200d6e0c841af26164db)) * standardize emoji badge width with consistent spacing for uniform alignment ([0777a1c](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/0777a1c712002c7a60f28e224788d264fa43e734)) ### Features * enhance badges with vivid colors, matching darker emoji backgrounds, left-aligned headers, and consistent 25-character text width ([403fda1](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/403fda1676c5475d656b6ebba53ef32921f6ae3c)) # [1.6.0](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.5.0...v1.6.0) (2025-09-11) ### Bug Fixes * revert to user-generated reply content instead of templates ([4439dff](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/4439dff264097c1e06d2ffc88b938aaf08e63803)) * show draft preview in readable format instead of artifacts ([18a3539](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/18a3539d11ec88a05059e5ef01242308627c1b87)) ### Features * show draft as previewable artifact with To, Subject, and Message ([af7db0c](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/af7db0c9aed4e54789d9bd512a2db7684912952e)) * show draft preview in markdown format for user review ([a7354dc](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/a7354dcbdf3d0af8c5d09c265a82e04e7411632e)) # [1.5.0](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.4.0...v1.5.0) (2025-09-11) ### Features * enhance reply tool to create actual Gmail drafts ([853934f](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/853934ff707a3a07e9a5cf6a397c6792d7d1b13d)) ## [1.3.5](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.3.4...v1.3.5) (2025-09-03) ### Bug Fixes * auth buttons urls ([991cfe1](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/991cfe1b71c314d5decead5cd9b8bdce97c29297)) * remove IDE-specific directories from tracking ([e5992bd](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/e5992bdd8e89e10091719ed5e07a044c0a1c8524)) * remove Windows environment variable paths and enhance .gitignore ([dd736b8](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/dd736b897f3d26c41fa7e69164ef8fdc47fe6829)) * resolve Smithery deployment issues ([d1a8361](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/d1a83618118ea0f3207057822ba911b409610a6e)) * support button added to auth page ([dab84f2](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/dab84f20c546c3518a6b14df8f95d3506a402621)) ## [1.3.5](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.3.4...v1.3.5) (2025-09-03) ### Bug Fixes * auth buttons urls ([991cfe1](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/991cfe1b71c314d5decead5cd9b8bdce97c29297)) * remove IDE-specific directories from tracking ([e5992bd](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/e5992bdd8e89e10091719ed5e07a044c0a1c8524)) * remove Windows environment variable paths and enhance .gitignore ([dd736b8](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/dd736b897f3d26c41fa7e69164ef8fdc47fe6829)) * resolve Smithery deployment issues ([d1a8361](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/d1a83618118ea0f3207057822ba911b409610a6e)) ## [1.3.5](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.3.4...v1.3.5) (2025-09-02) ### Bug Fixes * remove IDE-specific directories from tracking ([e5992bd](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/e5992bdd8e89e10091719ed5e07a044c0a1c8524)) * remove Windows environment variable paths and enhance .gitignore ([dd736b8](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/dd736b897f3d26c41fa7e69164ef8fdc47fe6829)) ## [1.3.4](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.3.3...v1.3.4) (2025-09-02) ### Bug Fixes * add .npmignore and optimize package for npx compatibility ([7649283](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/76492834498e48ce94f5dc3ed6c1cb2c1bd6823a)) * resolve npx installation issues and update documentation ([41171c0](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/41171c09b885844e58b1d3185a2c12f352d4323c)) ## [1.3.3](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.3.2...v1.3.3) (2025-09-01) ### Bug Fixes * zod package locked ([6347ade](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/6347aded6cba612817437bd11caa99cbf13f689f)) ## [1.3.2](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.3.1...v1.3.2) (2025-08-31) ### Bug Fixes * auth scope corrected ([96d8c20](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/96d8c205261962bd2f42c64abf4190dd5373b26e)) * prettier auth pages ([756c57a](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/756c57a16f2189490b2886ab0c6ec8924a19c4af)) * update OAuth scope to enable permanent email deletion ([6109e9a](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/6109e9ac879e20eba805a5bf47fe8eb2e66e4661)) ## [1.3.1](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.3.0...v1.3.1) (2025-08-31) ### Bug Fixes * Clean up project and simplify auth HTML pages ([c56ee10](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/c56ee10ba80e9d411d63805d5c92f7447cda5835)) * ES module syntax and stdout protocol errors ([d19d79e](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/d19d79e30e16f1e009651aa739340a9b18936d5d)) * Fix corrupted auth.ts file and restore missing functions ([84a97ed](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/84a97ed98630ac2c45a009a47cec0447d5718566)) * pretty auth pages ([4ec0877](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/4ec087734569af6c9608ec83d4bf34531a9f2357)) * prevent ERR_HTTP_HEADERS_SENT in OAuth callback ([8ff86f4](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/8ff86f44f95024ca292968a5a627111fe15f7672)) * resolve HTML file paths relative to project directory ([585d6dc](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/585d6dc65bbdacee31790321dfdb486a3c2512ae)) # [1.3.0](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.2.0...v1.3.0) (2025-08-31) ### Bug Fixes * Add proper redirect handling for OAuth authentication flow ([f3140b8](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/f3140b856156caf5c5dd9303a4a59adab59897c7)) * better auth ([de68b48](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/de68b48585c9a2d3f4636475b3ff58970b18b81b)) * Properly return null when no credentials exist to force authentication ([0b74d49](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/0b74d49e9afde4120267d456ca4a52fe5dd9c48f)) * Remove authentication caching to ensure fresh credential checks ([65de506](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/65de5064765d5597852ba96b0a344474ba4da3c4)) * Remove automatic authentication and improve OAuth key location handling ([21aee2d](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/21aee2ddde413e74efa121bdd6edd6ea360cb876)) * Remove emojis from JSON responses and restore automatic authentication ([47b5d33](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/47b5d33231702b86336023b60db76d94a2ec954d)) * Remove server-scoped authentication variables and add random GIF selection ([ba848d4](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/ba848d4723d69077f34997747adeef8dd62ac8ff)) * removed emojies error for Successful tool usage 🎉 ([88c2f18](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/88c2f18a49d6b2b9d93a2d8a0315db16494b59b4)) ### Features * Enhance authentication success page with animated background and redirect ([626dc6a](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/626dc6a905be71eec49b8d454d3c4a71e5edb0f2)) * Enhance authentication success page with emojis and better UX ([c14e23b](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/c14e23ba447f697dfbc6d2e301f21b1c0f3c861a)) # [1.2.0](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.7...v1.2.0) (2025-08-31) ### Features * using GMAIL_CREDENTIALS_PATH for Successful tool usage 🎉 ([d4b46f6](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/d4b46f68fe4c884a615ef4dfb4cf1788fc95128c)) ## [1.1.7](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.6...v1.1.7) (2025-08-30) ### Bug Fixes * add preferGlobal for better npm compatibility ([61b707a](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/61b707a83fc9f2fe3098ab56d5d311370eca378c)) * Gmail MCP Server now working with Claude Desktop! ([6ffb608](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/6ffb608b399c884cdd7c8867366812120f86a9c6)) * resolve Smithery Docker deployment issues ([bf99263](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/bf99263f0c68d55ef05c88e84202f059412da920)) * revert to SDK v0.4.0 for Claude Desktop compatibility ([e5cf0f9](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/e5cf0f98f08330a1832efc5ddfa498282eaa4c9a)) * update package and documentation ([d92ab0c](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/d92ab0ce01aaa9a6762d3f5fac329fc1709385ec)) ## [1.1.6](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.5...v1.1.6) (2025-08-29) ### Bug Fixes * readme and npm package scope ([16fe343](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/16fe3437487f36de4f55bacdb1fb6aa12b525c55)) ## [1.1.5](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.4...v1.1.5) (2025-08-29) ### Bug Fixes * remove unnecessary files from git tracking ([9ac3e98](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/9ac3e98eafa27c2f0ffb999733e9452493febf01)) ## [1.1.4](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.3...v1.1.4) (2025-08-29) ### Bug Fixes * remove gcp-oauth.keys.json from tracking and clean up .gitignore ([9c4e145](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/9c4e145d51ee28ff00073bf67ffbd7fb59ca82fc)) * resolve import.meta.url CommonJS compatibility issue for Smithery deployment ([60b34de](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/60b34def343847146782eeeea9bf0e43de33bfed)) ## [1.1.3](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.2...v1.1.3) (2025-08-29) ### Bug Fixes * improve authentication flow and error messages for Claude Desktop ([0836e35](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/0836e358ac39aeadb413f1871a1276ea799f491a)) * resolve Smithery port conflict by using http mode and preventing dual server startup ([73a23f1](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/73a23f10bf0baf89ad883c1f7ad38bdda903b8d4)) ## [1.1.2](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.1...v1.1.2) (2025-08-29) ### Bug Fixes * add default export for Smithery compatibility ([c3f0e2f](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/c3f0e2f872f9338f489f192c26e311488d4c14c1)) * remove import.meta usage for CommonJS compatibility in Smithery deployments ([31feede](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/31feedec26afbb53b84edac5c0ebe1454f184ace)) * remove unnecessary import.meta type check preventing server startup ([4ddd77b](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/4ddd77b5ebb0989022b439452aa9ba8477f64702)) * smithery export format for stateful server compatibility ([e80dc2f](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/e80dc2fda97d148157112a5049d362becc66e955)) ## [1.1.1](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.1.0...v1.1.1) (2025-08-28) ### Bug Fixes * auth and local test ([aa44722](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/aa447226f8b5da01f34dee5dd51a1c606b64e24b)) * resolve open package container compatibility for Smithery deployment ([9f89495](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/9f89495bb59b2d14c67e7e868c8cde6a75c26476)) # [1.1.0](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.9...v1.1.0) (2025-08-28) ### Bug Fixes * suppress startup messages and handle missing credentials ([0adfbfc](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/0adfbfceec41e48b2ecbdd3e0d748efb060bd57a)) * suppress startup messages and handle missing credentials gracefully for Smithery scanning compatibility ([3cca323](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/3cca323b67edfe1394f374c05e8b399a72c6fd50)) * suppress startup messages in production for Smithery scanning compatibility ([23e28ef](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/23e28ef317528b1f23aa93f221d64b04b3923a8c)) ### Features * add HTTP server support for container deployments while maintaining stdio compatibility ([bb15f1b](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/bb15f1b59aae63fe143c6d5826ea0f2abe22a6ce)) ## [1.0.9](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.8...v1.0.9) (2025-08-27) ### Bug Fixes * add npm package preparation & Git-based installation options ([fe5267a](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/fe5267a170ddccfd8745606f36e59b97859e9a96)) * enhance UX with pre-auth CLI & copy-friendly ([188fa50](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/188fa50fb6c65a889d85e6ac291e2e37b005d947)) ## [1.0.8](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.7...v1.0.8) (2025-08-27) ### Bug Fixes * handle missing credentials gracefully for Smithery deployment ([991ea64](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/991ea64392da1f0d80d91ea17438a463d0ef8a7b)) * resolve TypeScript compilation errors for Smithery deployment ([5c36e03](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/5c36e03f6dc9a206fa6f5ee80e69909e083c373e)) * update MCP server to properly handle initialization & deployment ([713eb03](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/713eb03b66663fc6b3ebfc0602137819583948a4)) ## [1.0.7](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.6...v1.0.7) (2025-08-27) ### Bug Fixes * make smithery oauth configuration optional for scanning ([5c57e99](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/5c57e99597180697950d639a84a62db77819742c)) * prioritize local oauth keys file for Smithery compatibility ([57acaab](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/57acaab7526f724eadfc67b55d6a6267e3f200be)) ## [1.0.6](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.5...v1.0.6) (2025-08-27) ### Bug Fixes * prevent auth module browser open failure in headless environments ([43d0e61](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/43d0e61d660623939b75b2f747475acd145c49fe)) ## [1.0.5](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.4...v1.0.5) (2025-08-27) ### Bug Fixes * setting remote to false ([2fa6fa3](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/2fa6fa3cadc84041c1e342285ca4a96c8d96cc34)) * update Dockerfile and workflow for Smithery compatibility ([37b6cde](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/37b6cde5d2f43193099a3c79948b654db021c485)) * update MCP server to properly handle initialization protocol ([66f0c6f](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/66f0c6ffa4cd52352212e3ea156007b194771d8c)) # 📋 Changelog All notable changes to **Gmail Manager MCP** will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). --- ## [1.0.4](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.3...v1.0.4) (2025-08-27) ### Bug Fixes * update Dockerfile and workflow for Smithery compatibility ([57054a1](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/57054a18c438f27f62c8bba5cd13328543f34658)) ## [1.0.3](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.2...v1.0.3) (2025-08-27) ### Bug Fixes * add module field to package.json for Smithery CLI compatibility ([c40894d](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/c40894dc310d637347166d16ab8f2e3a21ccb3fc)) ## [1.0.2](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.1...v1.0.2) (2025-08-27) ### Bug Fixes * add HTTP transport support for Smithery deployment ([46d7d2e](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/46d7d2e4bdc4963b94b5aa57e7fe2f221f5749a0)) * simplify server transport & update smithery config ([2e856b4](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/2e856b46366b6b4d10c58067ef30139b974554ff)) ## [1.0.1](https://github.com/muammar-yacoob/GMail-Manager-MCP/compare/v1.0.0...v1.0.1) (2025-08-27) ### Bug Fixes * auto release ([d5f3561](https://github.com/muammar-yacoob/GMail-Manager-MCP/commit/d5f3561f93823f590844e5f8bc8e0bdf4fb9d8e5)) ## [Unreleased] 🚀 ### ✨ Added - Initial Gmail MCP server implementation - OAuth 2.0 authentication with Google APIs - Email management tools for organizing inbox - Search and filter capabilities - Label management functionality ### 🔧 Changed - Updated GitHub workflows to match project structure - Configured semantic-release for automated versioning ### 🐛 Fixed - Semantic release configuration for GitHub-only releases ### 📚 Documentation - Added comprehensive README with setup instructions - Created publishing guide for Smithery distribution --- ## Release Format This changelog follows these conventions: - 🚀 **Major** - Breaking changes - ✨ **Minor** - New features - 🐛 **Patch** - Bug fixes - 🔧 **Changed** - Improvements to existing features - 📚 **Documentation** - Documentation updates - 🗑️ **Removed** - Removed features - 🔒 **Security** - Security improvements --- *Generated automatically by [semantic-release](https://github.com/semantic-release/semantic-release)*