KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

MailToJson

★ 107 Open GitHub ↗

Small python script to parse incoming mail to JSON and POST it to a remote url (callback).

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MailToJson

Quick script to parse incoming mail and do a post with the content as JSON data.

## How to use

The work flow is quite simple. The script reads the mail mime message from STDIN, parses
the data and makes a POST call with RAW JSON to the url (passed as command line argument).

Example usage (command line):
```bash
cat mail.eml | python mailtojson.py -u https://dev.url/autoreply/handle.php
```

Example usage (postfix aliases):
```bash
mailtojson_autoreply: "|/nethosting/mailtojson/mailtojson.py -u https://dev.url/autoreply/handle.php"
```

## JSON Format

```yaml
json:
  headers:
    header_key1: value
    header_key2: value
  subject: "The email subject as utf-8 string"
  datetime: "2015-03-17 17:48:06"
  encoding: "utf-8"
  from:
    - { name: "Sender Name", email: "sender@email.com" }
  to:
    - { name: "Recipient Name", email: "recpient@email.com" }
    - { name: "Recipient Name 2", email: "recpient2@email.com" }
  cc:
    - { name: "Recipient Name", email: "recpient@email.com" }
    - { name: "Recipient Name 2", email: "recpient2@email.com" }
  parts:
    - { content_type: "text/plain", content: "body of this part", "headers": { "header_key1": value, "header_key2": value } }
    - { content_type: "text/html", content: "body of this part", "headers": { "header_key1": value, "header_key2": value } }
  attachments:
    - { filename": "invoice.pdf", content_type: "application/pdf", content: "base64 of binary data" }
    - { filename": "invoice2.pdf", content_type: "application/pdf", content: "base64 of binary data" }
```

### Handling JSON data in PHP

Here is a quick example of how to parse the JSON data posted by the mail to json script:

```php
<?php

$json_str  = file_get_contents("php://input");
$json_data = json_decode($json_str, true);

var_dump($json_data);
?>
```

# License

This code is released under [MIT license](https://github.com/Newsman/MailToJson/blob/master/LICENSE) by [Newsman App - Smart Email Service Provider](https://www.newsman.app).

MailToJson

Was this content helpful?

Recent Feedback

Download README