PHPackages                             inboxcom/mailcore-cli - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. inboxcom/mailcore-cli

ActiveProject[CLI &amp; Console](/categories/cli)

inboxcom/mailcore-cli
=====================

Command-line interface for the Mailcore mail-server API.

v0.1.5(3w ago)00MITPHPPHP &gt;=8.4

Since Jun 28Pushed 3w agoCompare

[ Source](https://github.com/Fjordmail/mailcore-cli)[ Packagist](https://packagist.org/packages/inboxcom/mailcore-cli)[ RSS](/packages/inboxcom-mailcore-cli/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependencies (6)Versions (7)Used By (0)

inboxcom/mailcore-cli
=====================

[](#inboxcommailcore-cli)

[![Latest Version](https://camo.githubusercontent.com/67ab0a44846893b70e0df6fa3b64a747ef9f8014a95072f6f82437ec55998a4c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e626f78636f6d2f6d61696c636f72652d636c692e737667)](https://packagist.org/packages/inboxcom/mailcore-cli)[![License](https://camo.githubusercontent.com/a266d4e6322ec2fce48ba848eec14543062da4b3eb9e25b9039d6462bf2bbfbf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f696e626f78636f6d2f6d61696c636f72652d636c692e737667)](LICENSE)

Command-line interface for the **Mailcore** mail-server control API, built on Symfony Console.

> **Unofficial.** Third-party tool; not published by Mailcore.

> **AI-assisted.** Code, tests, and docs were written largely by AI (Claude Code) under human direction and review.

Built on the [`inboxcom/mailcore-php`](https://packagist.org/packages/inboxcom/mailcore-php) core client.

Install
-------

[](#install)

As a project dependency:

```
composer require inboxcom/mailcore-cli
vendor/bin/mailcore list
```

…or globally, to get a `mailcore` command on your `PATH`:

```
composer global require inboxcom/mailcore-cli
```

Requires PHP &gt;= 8.4.

Usage
-----

[](#usage)

The CLI covers **every** API operation — one command per endpoint, grouped as `users:*`, `domains:*`, `mailboxplans:*`, `mailfilter:*`, `reports:*`, `datadump:*`. Run `mailcore list` to see them all.

```
export MAILCORE_API_KEY=your-api-key

mailcore users:list --filter='*' --limit=0,100
mailcore users:get holger@example.com          # detail view
mailcore users:add new@example.com 4           # prompts for the password
mailcore users:new-password new@example.com    # prompts for the password
mailcore domains:list
mailcore mailboxplans:list
mailcore mailfilter:rbl-lookup 8.8.8.8         # exit 1 if listed
mailcore mailfilter:cdl-lookup 8.8.8.8         # exit 1 if listed; --email= is informational
mailcore datadump:fetch --output=dump.pgp
```

Configuration
-------------

[](#configuration)

Credentials are resolved in this order (first non-empty wins):

1. Environment variables `MAILCORE_API_KEY` / `MAILCORE_BASE_URI`
2. INI file at `~/.config/mailcore/config.ini` (or `$XDG_CONFIG_HOME/mailcore/config.ini`)
3. Built-in default (base URI only)

```
; ~/.config/mailcore/config.ini   (see config.ini.example)
api_key         = "your-api-key"
base_uri        = "https://api.example.com"   ; optional
timeout         = 30   ; optional, seconds (0 disables); raise for large data dumps
connect_timeout = 10   ; optional, seconds (0 disables)
```

The timeouts also accept env overrides `MAILCORE_TIMEOUT` / `MAILCORE_CONNECT_TIMEOUT`.

```
mkdir -p ~/.config/mailcore
cp config.ini.example ~/.config/mailcore/config.ini
chmod 600 ~/.config/mailcore/config.ini   # keep the key private
```

Conventions:

- Credentials come from the environment or the config file above, **never CLI flags**, so the key stays out of shell history and `ps`.
- Passwords are read from a hidden prompt unless `--password=` is given, for the same reason.
- Predicate commands set a non-zero exit code on the "negative" result (`verify-password`, `rbl-lookup`) so they compose in scripts.
- List commands render tables; `datadump:fetch` streams raw bytes to stdout (or `--output` to a file).

Development &amp; full docs
---------------------------

[](#development--full-docs)

This package is developed in the [`Fjordmail/mailcore-sdk`](https://github.com/Fjordmail/mailcore-sdk) monorepo (this repository is a read-only subtree split). Issues and contributions belong there.

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance95

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

6

Last Release

23d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/64f0c9c84d4ad951dc67d4b428add0aac25ff2b4100b601a84ad7eaad7d8f916?d=identicon)[inboxcom](/maintainers/inboxcom)

---

Top Contributors

[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 commits)")[![sebastka](https://avatars.githubusercontent.com/u/35309144?v=4)](https://github.com/sebastka "sebastka (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/inboxcom-mailcore-cli/health.svg)

```
[![Health](https://phpackages.com/badges/inboxcom-mailcore-cli/health.svg)](https://phpackages.com/packages/inboxcom-mailcore-cli)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
