MCP Email Server

Instructions

Implementation Reference

• mcp_email_server/app.py:35-40 (handler)

  The core handler function for the 'add_email_account' tool, registered via @mcp.tool decorator. Adds the EmailSettings to config and persists it.
  @mcp.tool(description="Add a new email account configuration to the settings.") async def add_email_account(email: EmailSettings) -> str: settings = get_settings() settings.add_email(email) settings.store() return f"Successfully added email account '{email.account_name}'"
• mcp_email_server/config.py:73-80 (schema)

  Pydantic BaseModel defining the input schema EmailSettings used by the tool handler.
  class EmailSettings(AccountAttributes): full_name: str email_address: str incoming: EmailServer outgoing: EmailServer save_to_sent: bool = True # Save sent emails to IMAP Sent folder sent_folder_name: str | None = None # Override Sent folder name (auto-detect if None)
• mcp_email_server/config.py:258-261 (helper)

  Method on Settings class that appends the new email account to the emails list, triggering validation.
  def add_email(self, email: EmailSettings) -> None: """Use re-assigned for validation to work.""" self.emails = [email, *self.emails]
• mcp_email_server/config.py:319-324 (helper)

  Method on Settings class that serializes and writes the configuration to the TOML file.
  def store(self) -> None: toml_file = self.model_config["toml_file"] toml_file.parent.mkdir(parents=True, exist_ok=True) toml_file.write_text(self._to_toml()) logger.info(f"Settings stored in {toml_file}")
• mcp_email_server/config.py:329-335 (helper)

  Function that provides the singleton instance of Settings, loading from config.toml if needed.
  def get_settings(reload: bool = False) -> Settings: global _settings if not _settings or reload: logger.info(f"Loading settings from {CONFIG_PATH}") _settings = Settings() return _settings