https://github.com/ai-zerolab/mcp-email-server
IMAP and SMTP via MCP Server
https://github.com/ai-zerolab/mcp-email-server
Last synced: 6 months ago
JSON representation
IMAP and SMTP via MCP Server
- Host: GitHub
- URL: https://github.com/ai-zerolab/mcp-email-server
- Owner: ai-zerolab
- License: bsd-3-clause
- Created: 2025-02-24T12:46:46.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-04-06T03:39:36.000Z (6 months ago)
- Last Synced: 2025-04-06T03:46:31.565Z (6 months ago)
- Language: Python
- Size: 722 KB
- Stars: 14
- Watchers: 0
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **mcp-email-server** - IMAP and SMTP via MCP Server `python` `mcp` `server` `pip install git+https://github.com/ai-zerolab/mcp-email-server` (AI/ML)
- awesome-mcp-servers - **mcp-email-server** - IMAP and SMTP via MCP Server `python` `mcp` `server` `pip install git+https://github.com/ai-zerolab/mcp-email-server` (AI/ML)
- mcp-index - Email Server - Provides IMAP and SMTP functionalities through a standardized server interface for email handling and communication. (Email and Messaging)
README
# mcp-email-server
[](https://img.shields.io/github/v/release/ai-zerolab/mcp-email-server)
[](https://github.com/ai-zerolab/mcp-email-server/actions/workflows/main.yml?query=branch%3Amain)
[](https://codecov.io/gh/ai-zerolab/mcp-email-server)
[](https://img.shields.io/github/commit-activity/m/ai-zerolab/mcp-email-server)
[](https://img.shields.io/github/license/ai-zerolab/mcp-email-server)
[](https://smithery.ai/server/@ai-zerolab/mcp-email-server)
IMAP and SMTP via MCP Server
- **Github repository**:
- **Documentation**
## Installation
### Manual Installation
We recommend using [uv](https://github.com/astral-sh/uv) to manage your environment.
Try `uvx mcp-email-server@latest ui` to config, and use following configuration for mcp client:
```json
{
"mcpServers": {
"zerolib-email": {
"command": "uvx",
"args": ["mcp-email-server@latest", "stdio"]
}
}
}
```
This package is available on PyPI, so you can install it using `pip install mcp-email-server`
After that, configure your email server using the ui: `mcp-email-server ui`
Then you can try it in [Claude Desktop](https://claude.ai/download). If you want to intergrate it with other mcp client, run `$which mcp-email-server` for the path and configure it in your client like:
```json
{
"mcpServers": {
"zerolib-email": {
"command": "{{ ENTRYPOINT }}",
"args": ["stdio"]
}
}
}
```
If `docker` is avaliable, you can try use docker image, but you may need to config it in your client using `tools` via `MCP`. The default config path is `~/.config/zerolib/mcp_email_server/config.toml`
```json
{
"mcpServers": {
"zerolib-email": {
"command": "docker",
"args": ["run", "-it", "ghcr.io/ai-zerolab/mcp-email-server:latest"]
}
}
}
```
### Installing via Smithery
To install Email Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ai-zerolab/mcp-email-server):
```bash
npx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude
```
## Development
This project is managed using [uv](https://github.com/ai-zerolab/uv).
Try `make install` to install the virtual environment and install the pre-commit hooks.
Use `uv run mcp-email-server` for local development.
## Releasing a new version
- Create an API Token on [PyPI](https://pypi.org/).
- Add the API Token to your projects secrets with the name `PYPI_TOKEN` by visiting [this page](https://github.com/ai-zerolab/mcp-email-server/settings/secrets/actions/new).
- Create a [new release](https://github.com/ai-zerolab/mcp-email-server/releases/new) on Github.
- Create a new tag in the form `*.*.*`.
For more details, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/cicd/#how-to-trigger-a-release).