| Name | mcp-email-server JSON |
| Version |
0.1.3
JSON |
| download |
| home_page | None |
| Summary | IMAP and SMTP via MCP Server |
| upload_time | 2025-03-21 11:39:19 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <4.0,>=3.10 |
| license | None |
| keywords |
imap
mcp
smtp
email
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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**: <https://github.com/ai-zerolab/mcp-email-server/>
- **Documentation** <https://ai-zerolab.github.io/mcp-email-server/>
## 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).
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-email-server",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "IMAP, MCP, SMTP, email",
"author": null,
"author_email": "ai-zerolab <jizhongsheng957@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d9/f2/a560e0e7d6e79fc772ea3aafe04084095b5284c0e834f8c9bcfb5cf7a8b5/mcp_email_server-0.1.3.tar.gz",
"platform": null,
"description": "# mcp-email-server\n\n[](https://img.shields.io/github/v/release/ai-zerolab/mcp-email-server)\n[](https://github.com/ai-zerolab/mcp-email-server/actions/workflows/main.yml?query=branch%3Amain)\n[](https://codecov.io/gh/ai-zerolab/mcp-email-server)\n[](https://img.shields.io/github/commit-activity/m/ai-zerolab/mcp-email-server)\n[](https://img.shields.io/github/license/ai-zerolab/mcp-email-server)\n[](https://smithery.ai/server/@ai-zerolab/mcp-email-server)\n\nIMAP and SMTP via MCP Server\n\n- **Github repository**: <https://github.com/ai-zerolab/mcp-email-server/>\n- **Documentation** <https://ai-zerolab.github.io/mcp-email-server/>\n\n## Installation\n\n### Manual Installation\n\nWe recommend using [uv](https://github.com/astral-sh/uv) to manage your environment.\n\nTry `uvx mcp-email-server@latest ui` to config, and use following configuration for mcp client:\n\n```json\n{\n \"mcpServers\": {\n \"zerolib-email\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-email-server@latest\", \"stdio\"]\n }\n }\n}\n```\n\nThis package is available on PyPI, so you can install it using `pip install mcp-email-server`\n\nAfter that, configure your email server using the ui: `mcp-email-server ui`\n\nThen 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:\n\n```json\n{\n \"mcpServers\": {\n \"zerolib-email\": {\n \"command\": \"{{ ENTRYPOINT }}\",\n \"args\": [\"stdio\"]\n }\n }\n}\n```\n\nIf `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`\n\n```json\n{\n \"mcpServers\": {\n \"zerolib-email\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-it\", \"ghcr.io/ai-zerolab/mcp-email-server:latest\"]\n }\n }\n}\n```\n\n### Installing via Smithery\n\nTo install Email Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ai-zerolab/mcp-email-server):\n\n```bash\nnpx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude\n```\n\n## Development\n\nThis project is managed using [uv](https://github.com/ai-zerolab/uv).\n\nTry `make install` to install the virtual environment and install the pre-commit hooks.\n\nUse `uv run mcp-email-server` for local development.\n\n## Releasing a new version\n\n- Create an API Token on [PyPI](https://pypi.org/).\n- 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).\n- Create a [new release](https://github.com/ai-zerolab/mcp-email-server/releases/new) on Github.\n- Create a new tag in the form `*.*.*`.\n\nFor more details, see [here](https://fpgmaas.github.io/cookiecutter-uv/features/cicd/#how-to-trigger-a-release).\n",
"bugtrack_url": null,
"license": null,
"summary": "IMAP and SMTP via MCP Server",
"version": "0.1.3",
"project_urls": {
"Documentation": "https://ai-zerolab.github.io/mcp-email-server/",
"Homepage": "https://ai-zerolab.github.io/mcp-email-server/",
"Repository": "https://github.com/ai-zerolab/mcp-email-server"
},
"split_keywords": [
"imap",
" mcp",
" smtp",
" email"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d35d517a96ba519a8d800515373155b6e57d95eba5bcc2c261235137e5316f14",
"md5": "80c91f4a7a053431b296b88792a064ef",
"sha256": "dac750842a18499ee794d4a53c5548f631c64efa31bec0f7ed8ae8f1cf636584"
},
"downloads": -1,
"filename": "mcp_email_server-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "80c91f4a7a053431b296b88792a064ef",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 17891,
"upload_time": "2025-03-21T11:39:18",
"upload_time_iso_8601": "2025-03-21T11:39:18.090742Z",
"url": "https://files.pythonhosted.org/packages/d3/5d/517a96ba519a8d800515373155b6e57d95eba5bcc2c261235137e5316f14/mcp_email_server-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d9f2a560e0e7d6e79fc772ea3aafe04084095b5284c0e834f8c9bcfb5cf7a8b5",
"md5": "67b37ee7b216a0d643be2345aec37104",
"sha256": "cb5abfacbc56e5c3a6a466a79c65ae7106a0ef5197f603d32382b093896c6c24"
},
"downloads": -1,
"filename": "mcp_email_server-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "67b37ee7b216a0d643be2345aec37104",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 112806,
"upload_time": "2025-03-21T11:39:19",
"upload_time_iso_8601": "2025-03-21T11:39:19.391772Z",
"url": "https://files.pythonhosted.org/packages/d9/f2/a560e0e7d6e79fc772ea3aafe04084095b5284c0e834f8c9bcfb5cf7a8b5/mcp_email_server-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-21 11:39:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ai-zerolab",
"github_project": "mcp-email-server",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "mcp-email-server"
}
