iflow-mcp_mcp-email-server


Nameiflow-mcp_mcp-email-server JSON
Version 0.0.2 PyPI version JSON
download
home_pageNone
SummaryIMAP and SMTP via MCP Server
upload_time2025-08-19 09:46:03
maintainerNone
docs_urlNone
authorNone
requires_python<4.0,>=3.10
licenseNone
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

[![Release](https://img.shields.io/github/v/release/ai-zerolab/mcp-email-server)](https://img.shields.io/github/v/release/ai-zerolab/mcp-email-server)
[![Build status](https://img.shields.io/github/actions/workflow/status/ai-zerolab/mcp-email-server/main.yml?branch=main)](https://github.com/ai-zerolab/mcp-email-server/actions/workflows/main.yml?query=branch%3Amain)
[![codecov](https://codecov.io/gh/ai-zerolab/mcp-email-server/branch/main/graph/badge.svg)](https://codecov.io/gh/ai-zerolab/mcp-email-server)
[![Commit activity](https://img.shields.io/github/commit-activity/m/ai-zerolab/mcp-email-server)](https://img.shields.io/github/commit-activity/m/ai-zerolab/mcp-email-server)
[![License](https://img.shields.io/github/license/ai-zerolab/mcp-email-server)](https://img.shields.io/github/license/ai-zerolab/mcp-email-server)
[![smithery badge](https://smithery.ai/badge/@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": "iflow-mcp_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/c6/a0/22ba743fc3e34c012c6c541b33250c77927a00df321c156322deba6aec4d/iflow_mcp_mcp_email_server-0.0.2.tar.gz",
    "platform": null,
    "description": "# mcp-email-server\n\n[![Release](https://img.shields.io/github/v/release/ai-zerolab/mcp-email-server)](https://img.shields.io/github/v/release/ai-zerolab/mcp-email-server)\n[![Build status](https://img.shields.io/github/actions/workflow/status/ai-zerolab/mcp-email-server/main.yml?branch=main)](https://github.com/ai-zerolab/mcp-email-server/actions/workflows/main.yml?query=branch%3Amain)\n[![codecov](https://codecov.io/gh/ai-zerolab/mcp-email-server/branch/main/graph/badge.svg)](https://codecov.io/gh/ai-zerolab/mcp-email-server)\n[![Commit activity](https://img.shields.io/github/commit-activity/m/ai-zerolab/mcp-email-server)](https://img.shields.io/github/commit-activity/m/ai-zerolab/mcp-email-server)\n[![License](https://img.shields.io/github/license/ai-zerolab/mcp-email-server)](https://img.shields.io/github/license/ai-zerolab/mcp-email-server)\n[![smithery badge](https://smithery.ai/badge/@ai-zerolab/mcp-email-server)](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.0.2",
    "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": "0ca164fd1f8b87a6169d75df5eff5203b3acf84778a552e2bb849fc56baf609b",
                "md5": "07c387cb7683cb6ddfd474afecd473de",
                "sha256": "d5e7ebf848c35ea394036adf6b4c78ede05f4268c25165ac7e49bfa81ffc61e6"
            },
            "downloads": -1,
            "filename": "iflow_mcp_mcp_email_server-0.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "07c387cb7683cb6ddfd474afecd473de",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.10",
            "size": 18600,
            "upload_time": "2025-08-19T09:46:01",
            "upload_time_iso_8601": "2025-08-19T09:46:01.575448Z",
            "url": "https://files.pythonhosted.org/packages/0c/a1/64fd1f8b87a6169d75df5eff5203b3acf84778a552e2bb849fc56baf609b/iflow_mcp_mcp_email_server-0.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "c6a022ba743fc3e34c012c6c541b33250c77927a00df321c156322deba6aec4d",
                "md5": "5d7485c38e971c5fa54702db88fff479",
                "sha256": "7a305dd986c1a096b410669377460441d8479827f1bf1a01190fd1232bb89e31"
            },
            "downloads": -1,
            "filename": "iflow_mcp_mcp_email_server-0.0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "5d7485c38e971c5fa54702db88fff479",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.10",
            "size": 116497,
            "upload_time": "2025-08-19T09:46:03",
            "upload_time_iso_8601": "2025-08-19T09:46:03.352475Z",
            "url": "https://files.pythonhosted.org/packages/c6/a0/22ba743fc3e34c012c6c541b33250c77927a00df321c156322deba6aec4d/iflow_mcp_mcp_email_server-0.0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-19 09:46:03",
    "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": "iflow-mcp_mcp-email-server"
}
None
Elapsed time: 1.06466s