| Name | mcp-email-client-cybergenix JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | A Python-based MCP (Model Context Protocol) email client for managing email configurations and interactions with Claude Desktop |
| upload_time | 2025-08-07 15:37:40 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | MIT |
| keywords |
claude
client
desktop
email
mail
mcp
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# MCP Email Client
[](https://badge.fury.io/py/mcp-email-client)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
## Overview
MCP Email Client is a Python-based email management tool that implements the Model Context Protocol (MCP) for seamless integration with Claude Desktop. It provides comprehensive email functionality including configuration management, sending emails, and reading messages with semantic search capabilities.
## Features
- 📧 **Email Configuration Management**: List, add, update, and delete email configurations
- 📨 **Send Emails**: Send emails using specified configurations
- 📖 **Read Emails**: Access and read the latest unread emails
- 🔍 **Semantic Search**: Advanced email search with AI-powered semantic understanding
- 🗃️ **Database Storage**: Efficient email storage using DuckDB
- 🔌 **MCP Integration**: Native support for Claude Desktop integration
## Installation
### From PyPI (Recommended)
```bash
pip install mcp-email-client
```
### From Source
1. Clone the repository:
```bash
git clone https://github.com/gamalan/mcp-email-client.git
cd mcp-email-client
```
2. Install uv (if not already installed):
**Linux/MacOS:**
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
**Windows:**
```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
3. Install dependencies:
```bash
uv sync
```
## Quick Start
After installation, you can run the MCP email client directly:
```bash
mcp-email-client
```
## Configuration
Configuration example using Claude Desktop
```json
{
"mcpServers": {
"mcp_email_client": {
"command": "uv",
"args": [
"run",
"--directory",
"D:\\Project\\RepoPath",
"mcp_email_client"
]
}
}
}
```
**For VS Code:**
```json
{
"servers": {
"mcp-email-client": {
"type": "stdio",
"command": "mcp-email-client",
"args": []
}
}
}
```
**For development/local installation:**
```json
{
"servers": {
"mcp-email-client": {
"type": "stdio",
"command": "/path/to/uv",
"args": [
"run",
"--directory",
"/path/to/repo",
"run_mcp_server.py"
]
}
}
}
```
## Usage
The MCP Email Client provides several tools that can be used through Claude Desktop:
- **List Configurations**: View all configured email accounts
- **Add Configuration**: Add new email account settings
- **Update Configuration**: Modify existing email configurations
- **Delete Configuration**: Remove email configurations
- **Send Email**: Send emails through configured accounts
- **Read Emails**: Access latest unread emails
- **Search Emails**: Semantic search through email content
## Requirements
- Python 3.12 or higher
- DuckDB for local email storage
- Internet connection for email operations
- Valid email account credentials (IMAP/SMTP)
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Support
If you encounter any issues or have questions, please file an issue on the [GitHub repository](https://github.com/gamalan/mcp-email-client/issues).
## Changelog
### v0.1.0
- Initial release
- Basic email configuration management
- Email sending and reading functionality
- MCP integration for Claude Desktop
- Semantic search capabilities
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-email-client-cybergenix",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": "Cybergenix <it@cybergenix.co>",
"keywords": "claude, client, desktop, email, mail, mcp",
"author": null,
"author_email": "Cybergenix <it@cybergenix.co>",
"download_url": "https://files.pythonhosted.org/packages/f1/85/4f08fe23b6f0d805acef6244a2df6600dea9c53442c7289d2e9321f9b1e6/mcp_email_client_cybergenix-0.1.0.tar.gz",
"platform": null,
"description": "# MCP Email Client\n\n[](https://badge.fury.io/py/mcp-email-client)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n\n## Overview\n\nMCP Email Client is a Python-based email management tool that implements the Model Context Protocol (MCP) for seamless integration with Claude Desktop. It provides comprehensive email functionality including configuration management, sending emails, and reading messages with semantic search capabilities.\n\n## Features\n\n- \ud83d\udce7 **Email Configuration Management**: List, add, update, and delete email configurations\n- \ud83d\udce8 **Send Emails**: Send emails using specified configurations\n- \ud83d\udcd6 **Read Emails**: Access and read the latest unread emails\n- \ud83d\udd0d **Semantic Search**: Advanced email search with AI-powered semantic understanding\n- \ud83d\uddc3\ufe0f **Database Storage**: Efficient email storage using DuckDB\n- \ud83d\udd0c **MCP Integration**: Native support for Claude Desktop integration\n\n## Installation\n\n### From PyPI (Recommended)\n\n```bash\npip install mcp-email-client\n```\n\n### From Source\n\n1. Clone the repository:\n ```bash\n git clone https://github.com/gamalan/mcp-email-client.git\n cd mcp-email-client\n ```\n\n2. Install uv (if not already installed):\n \n **Linux/MacOS:**\n ```bash\n curl -LsSf https://astral.sh/uv/install.sh | sh\n ```\n \n **Windows:**\n ```powershell\n powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n ```\n\n3. Install dependencies:\n ```bash\n uv sync\n ```\n\n## Quick Start\n\nAfter installation, you can run the MCP email client directly:\n\n```bash\nmcp-email-client\n```\n\n## Configuration\n\nConfiguration example using Claude Desktop\n```json\n{\n \"mcpServers\": {\n \"mcp_email_client\": {\n \"command\": \"uv\",\n \"args\": [\n \"run\",\n \"--directory\",\n \"D:\\\\Project\\\\RepoPath\", \n \"mcp_email_client\"\n ]\n }\n }\n}\n```\n\n**For VS Code:**\n\n```json\n{\n \"servers\": {\n \"mcp-email-client\": {\n \"type\": \"stdio\",\n \"command\": \"mcp-email-client\",\n \"args\": []\n }\n }\n}\n```\n\n**For development/local installation:**\n\n```json\n{\n \"servers\": {\n \"mcp-email-client\": {\n \"type\": \"stdio\",\n \"command\": \"/path/to/uv\",\n \"args\": [\n \"run\",\n \"--directory\",\n \"/path/to/repo\",\n \"run_mcp_server.py\"\n ]\n }\n }\n}\n```\n\n## Usage\n\nThe MCP Email Client provides several tools that can be used through Claude Desktop:\n\n- **List Configurations**: View all configured email accounts\n- **Add Configuration**: Add new email account settings\n- **Update Configuration**: Modify existing email configurations\n- **Delete Configuration**: Remove email configurations\n- **Send Email**: Send emails through configured accounts\n- **Read Emails**: Access latest unread emails\n- **Search Emails**: Semantic search through email content\n\n## Requirements\n\n- Python 3.12 or higher\n- DuckDB for local email storage\n- Internet connection for email operations\n- Valid email account credentials (IMAP/SMTP)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\nIf you encounter any issues or have questions, please file an issue on the [GitHub repository](https://github.com/gamalan/mcp-email-client/issues).\n\n## Changelog\n\n### v0.1.0\n- Initial release\n- Basic email configuration management\n- Email sending and reading functionality\n- MCP integration for Claude Desktop\n- Semantic search capabilities",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python-based MCP (Model Context Protocol) email client for managing email configurations and interactions with Claude Desktop",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://github.com/gamalan/mcp-email-client#readme",
"Homepage": "https://github.com/gamalan/mcp-email-client",
"Issues": "https://github.com/gamalan/mcp-email-client/issues",
"Repository": "https://github.com/gamalan/mcp-email-client.git"
},
"split_keywords": [
"claude",
" client",
" desktop",
" email",
" mail",
" mcp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "94defd57db0b978de3ea7f0de366c9dbedb45872e62bcd24d5ed96d0fd0711af",
"md5": "17875cfd8b1f04d92bff941766199daf",
"sha256": "9c8601bd5164b57c408ad61401a2224e10326595ece233a32309e3729d827642"
},
"downloads": -1,
"filename": "mcp_email_client_cybergenix-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "17875cfd8b1f04d92bff941766199daf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 15555,
"upload_time": "2025-08-07T15:37:38",
"upload_time_iso_8601": "2025-08-07T15:37:38.585014Z",
"url": "https://files.pythonhosted.org/packages/94/de/fd57db0b978de3ea7f0de366c9dbedb45872e62bcd24d5ed96d0fd0711af/mcp_email_client_cybergenix-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f1854f08fe23b6f0d805acef6244a2df6600dea9c53442c7289d2e9321f9b1e6",
"md5": "fc319e913d27a06372aea56bdde36415",
"sha256": "e57e8db38396550e9592108c64635c8281871804691f9ef141be9564e2a6e136"
},
"downloads": -1,
"filename": "mcp_email_client_cybergenix-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "fc319e913d27a06372aea56bdde36415",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 12297,
"upload_time": "2025-08-07T15:37:40",
"upload_time_iso_8601": "2025-08-07T15:37:40.081798Z",
"url": "https://files.pythonhosted.org/packages/f1/85/4f08fe23b6f0d805acef6244a2df6600dea9c53442c7289d2e9321f9b1e6/mcp_email_client_cybergenix-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 15:37:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gamalan",
"github_project": "mcp-email-client#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "mcp-email-client-cybergenix"
}
