thunderbird-mcp 0.4.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- thunderbird_mcp-0.4.1/.github/ISSUE_TEMPLATE/bug-report.yml +53 -0
- thunderbird_mcp-0.4.1/.github/ISSUE_TEMPLATE/config.yml +8 -0
- thunderbird_mcp-0.4.1/.github/ISSUE_TEMPLATE/installation-feedback.yml +77 -0
- thunderbird_mcp-0.4.1/.github/workflows/checks.yml +71 -0
- thunderbird_mcp-0.4.1/.github/workflows/release.yml +146 -0
- thunderbird_mcp-0.4.1/.gitignore +29 -0
- thunderbird_mcp-0.4.1/CHANGELOG.md +195 -0
- thunderbird_mcp-0.4.1/CONTRIBUTING.md +142 -0
- thunderbird_mcp-0.4.1/LICENSE +21 -0
- thunderbird_mcp-0.4.1/PKG-INFO +591 -0
- thunderbird_mcp-0.4.1/README.md +555 -0
- thunderbird_mcp-0.4.1/ROADMAP.md +75 -0
- thunderbird_mcp-0.4.1/docs/README.md +26 -0
- thunderbird_mcp-0.4.1/docs/comparison.md +169 -0
- thunderbird_mcp-0.4.1/docs/demo.md +37 -0
- thunderbird_mcp-0.4.1/docs/demo.svg +41 -0
- thunderbird_mcp-0.4.1/docs/faq.md +146 -0
- thunderbird_mcp-0.4.1/docs/implementation-status.md +69 -0
- thunderbird_mcp-0.4.1/docs/installation.md +220 -0
- thunderbird_mcp-0.4.1/docs/native-integration.md +104 -0
- thunderbird_mcp-0.4.1/docs/repository-traffic.md +53 -0
- thunderbird_mcp-0.4.1/docs/workflows.md +243 -0
- thunderbird_mcp-0.4.1/pyproject.toml +73 -0
- thunderbird_mcp-0.4.1/scripts/benchmark_search.py +220 -0
- thunderbird_mcp-0.4.1/scripts/demo.py +269 -0
- thunderbird_mcp-0.4.1/scripts/repo_traffic.py +140 -0
- thunderbird_mcp-0.4.1/scripts/setup_native_bridge.py +183 -0
- thunderbird_mcp-0.4.1/scripts/test_clients.py +227 -0
- thunderbird_mcp-0.4.1/scripts/test_install.py +315 -0
- thunderbird_mcp-0.4.1/scripts/test_windows_install.py +144 -0
- thunderbird_mcp-0.4.1/systemd/mail-index.service +12 -0
- thunderbird_mcp-0.4.1/systemd/mail-index.timer +9 -0
- thunderbird_mcp-0.4.1/systemd/mail-search.service +23 -0
- thunderbird_mcp-0.4.1/systemd/thunderbird-repo-traffic.service +13 -0
- thunderbird_mcp-0.4.1/systemd/thunderbird-repo-traffic.timer +11 -0
- thunderbird_mcp-0.4.1/tests/test_accounts.py +184 -0
- thunderbird_mcp-0.4.1/tests/test_attachments.py +131 -0
- thunderbird_mcp-0.4.1/tests/test_automation.py +279 -0
- thunderbird_mcp-0.4.1/tests/test_benchmark.py +35 -0
- thunderbird_mcp-0.4.1/tests/test_cli.py +170 -0
- thunderbird_mcp-0.4.1/tests/test_client_smoke.py +44 -0
- thunderbird_mcp-0.4.1/tests/test_demo.py +98 -0
- thunderbird_mcp-0.4.1/tests/test_enrollment.py +135 -0
- thunderbird_mcp-0.4.1/tests/test_imap.py +75 -0
- thunderbird_mcp-0.4.1/tests/test_index.py +254 -0
- thunderbird_mcp-0.4.1/tests/test_insights.py +47 -0
- thunderbird_mcp-0.4.1/tests/test_install.py +119 -0
- thunderbird_mcp-0.4.1/tests/test_integration.py +192 -0
- thunderbird_mcp-0.4.1/tests/test_live.py +280 -0
- thunderbird_mcp-0.4.1/tests/test_mailbox.py +163 -0
- thunderbird_mcp-0.4.1/tests/test_maildir.py +178 -0
- thunderbird_mcp-0.4.1/tests/test_messages.py +150 -0
- thunderbird_mcp-0.4.1/tests/test_native_bridge.py +176 -0
- thunderbird_mcp-0.4.1/tests/test_oauth.py +172 -0
- thunderbird_mcp-0.4.1/tests/test_ocr.py +145 -0
- thunderbird_mcp-0.4.1/tests/test_operations.py +135 -0
- thunderbird_mcp-0.4.1/tests/test_outgoing.py +673 -0
- thunderbird_mcp-0.4.1/tests/test_pagination_exports.py +71 -0
- thunderbird_mcp-0.4.1/tests/test_policy.py +144 -0
- thunderbird_mcp-0.4.1/tests/test_profile.py +79 -0
- thunderbird_mcp-0.4.1/tests/test_providers.py +268 -0
- thunderbird_mcp-0.4.1/tests/test_remote.py +84 -0
- thunderbird_mcp-0.4.1/tests/test_remote_boundaries.py +141 -0
- thunderbird_mcp-0.4.1/tests/test_runtime.py +113 -0
- thunderbird_mcp-0.4.1/tests/test_search.py +155 -0
- thunderbird_mcp-0.4.1/tests/test_server.py +215 -0
- thunderbird_mcp-0.4.1/tests/test_service.py +51 -0
- thunderbird_mcp-0.4.1/tests/test_windows_setup.py +105 -0
- thunderbird_mcp-0.4.1/tests/test_workflow_integration.py +144 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/__init__.py +8 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/attachments.py +302 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/automation.py +441 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/cli.py +450 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/enrollment.py +226 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/exports.py +189 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/imap.py +353 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/index.py +547 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/insights.py +156 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/live.py +506 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/mailbox.py +295 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/maildir.py +206 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/messages.py +448 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/oauth.py +296 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/ocr.py +240 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/operations.py +288 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/outgoing.py +1245 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/pagination.py +146 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/policy.py +336 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/profile.py +151 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/providers.py +543 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/remote.py +185 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/runtime.py +62 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/search.py +541 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/server.py +756 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/service.py +73 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/setup.py +379 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/status.py +115 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/web.html +173 -0
- thunderbird_mcp-0.4.1/thunderbird_mcp/web.py +109 -0
- thunderbird_mcp-0.4.1/uv.lock +2567 -0
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
name: Bug report
|
|
2
|
+
description: Describe a reproducible problem using sanitized or synthetic examples.
|
|
3
|
+
title: "[Bug]: "
|
|
4
|
+
body:
|
|
5
|
+
- type: markdown
|
|
6
|
+
attributes:
|
|
7
|
+
value: |
|
|
8
|
+
For installation successes or failures, use the Installation feedback form.
|
|
9
|
+
This issue is public. Use fictional mail and redact private addresses, hosts, paths, tokens, and passwords.
|
|
10
|
+
Do not upload original mail, attachments, databases, full client configuration, or unreviewed logs.
|
|
11
|
+
A bug report does not require sending mail or retrying an uncertain delivery.
|
|
12
|
+
- type: input
|
|
13
|
+
id: project_version
|
|
14
|
+
attributes:
|
|
15
|
+
label: Thunderbird MCP version or Git commit
|
|
16
|
+
placeholder: v0.3.1 or a commit hash
|
|
17
|
+
validations:
|
|
18
|
+
required: true
|
|
19
|
+
- type: textarea
|
|
20
|
+
id: environment
|
|
21
|
+
attributes:
|
|
22
|
+
label: Relevant software versions
|
|
23
|
+
placeholder: |
|
|
24
|
+
OS/version and architecture:
|
|
25
|
+
Python and uv versions:
|
|
26
|
+
Thunderbird version (if relevant):
|
|
27
|
+
Client/version and model/provider (if relevant):
|
|
28
|
+
validations:
|
|
29
|
+
required: true
|
|
30
|
+
- type: textarea
|
|
31
|
+
id: reproduction
|
|
32
|
+
attributes:
|
|
33
|
+
label: Steps to reproduce
|
|
34
|
+
description: Include the command or tool name and a small synthetic example. Authentication reports need only the protocol, auth type, and redacted error.
|
|
35
|
+
placeholder: |
|
|
36
|
+
1. Prepare this fictional message or configuration...
|
|
37
|
+
2. Run this command or tool...
|
|
38
|
+
3. Observe...
|
|
39
|
+
validations:
|
|
40
|
+
required: true
|
|
41
|
+
- type: textarea
|
|
42
|
+
id: expected
|
|
43
|
+
attributes:
|
|
44
|
+
label: Expected result
|
|
45
|
+
validations:
|
|
46
|
+
required: true
|
|
47
|
+
- type: textarea
|
|
48
|
+
id: actual
|
|
49
|
+
attributes:
|
|
50
|
+
label: Actual result
|
|
51
|
+
description: Include only a reviewed, sanitized error snippet if available.
|
|
52
|
+
validations:
|
|
53
|
+
required: true
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
blank_issues_enabled: true
|
|
2
|
+
contact_links:
|
|
3
|
+
- name: Installation and client setup instructions
|
|
4
|
+
url: https://github.com/simonjamescarroll/thunderbirdmcp#start-using-it
|
|
5
|
+
about: Find setup, reconnect, credential configuration, and verification instructions.
|
|
6
|
+
- name: Contributing and verification guidance
|
|
7
|
+
url: https://github.com/simonjamescarroll/thunderbirdmcp/blob/main/CONTRIBUTING.md
|
|
8
|
+
about: Learn how to share a synthetic reproduction or an independent installation report.
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
name: Installation feedback
|
|
2
|
+
description: Report a successful install, a partial result, or an installation problem.
|
|
3
|
+
title: "[Install]: "
|
|
4
|
+
body:
|
|
5
|
+
- type: markdown
|
|
6
|
+
attributes:
|
|
7
|
+
value: |
|
|
8
|
+
Successful installations are useful reports too. Include only the checks you actually ran.
|
|
9
|
+
This issue is public: replace personal addresses, hostnames, usernames, and paths with placeholders.
|
|
10
|
+
Do not include mail, attachments, databases, credentials, full client configs, or unreviewed logs.
|
|
11
|
+
- type: dropdown
|
|
12
|
+
id: outcome
|
|
13
|
+
attributes:
|
|
14
|
+
label: Installation outcome
|
|
15
|
+
options:
|
|
16
|
+
- Installed and working for the checks below
|
|
17
|
+
- Partially working
|
|
18
|
+
- Installation failed
|
|
19
|
+
validations:
|
|
20
|
+
required: true
|
|
21
|
+
- type: input
|
|
22
|
+
id: project_version
|
|
23
|
+
attributes:
|
|
24
|
+
label: Thunderbird MCP version or Git commit
|
|
25
|
+
description: Use the release version or the output of git rev-parse --short HEAD.
|
|
26
|
+
placeholder: v0.3.1 or a commit hash
|
|
27
|
+
validations:
|
|
28
|
+
required: true
|
|
29
|
+
- type: textarea
|
|
30
|
+
id: environment
|
|
31
|
+
attributes:
|
|
32
|
+
label: Software versions and environment
|
|
33
|
+
description: Include versions when known; write not installed or unknown where appropriate. No account details are needed.
|
|
34
|
+
placeholder: |
|
|
35
|
+
OS/version and architecture:
|
|
36
|
+
Python version:
|
|
37
|
+
uv version:
|
|
38
|
+
Thunderbird version and install method (native, Flatpak, Snap, other):
|
|
39
|
+
Client(s) and version(s):
|
|
40
|
+
Model/provider, if relevant:
|
|
41
|
+
validations:
|
|
42
|
+
required: true
|
|
43
|
+
- type: textarea
|
|
44
|
+
id: install_commands
|
|
45
|
+
attributes:
|
|
46
|
+
label: Installation commands
|
|
47
|
+
description: Paste the commands you ran, replacing personal paths and any secret values with placeholders.
|
|
48
|
+
render: shell
|
|
49
|
+
placeholder: |
|
|
50
|
+
git clone https://github.com/simonjamescarroll/thunderbirdmcp.git
|
|
51
|
+
cd thunderbirdmcp
|
|
52
|
+
uv sync --locked
|
|
53
|
+
uv run thunderbird-mcp-setup --apply --clients codex
|
|
54
|
+
validations:
|
|
55
|
+
required: true
|
|
56
|
+
- type: textarea
|
|
57
|
+
id: checks
|
|
58
|
+
attributes:
|
|
59
|
+
label: Checks and results
|
|
60
|
+
description: Describe what passed, failed, or was not run. A real mailbox connection or test email is not required.
|
|
61
|
+
placeholder: |
|
|
62
|
+
Command setup:
|
|
63
|
+
Synthetic tests or demo:
|
|
64
|
+
Client lists the Thunderbird tools:
|
|
65
|
+
Synthetic client search/read/reference:
|
|
66
|
+
Optional readonly live mail check:
|
|
67
|
+
What did not work or was not tested:
|
|
68
|
+
validations:
|
|
69
|
+
required: true
|
|
70
|
+
- type: textarea
|
|
71
|
+
id: errors
|
|
72
|
+
attributes:
|
|
73
|
+
label: Sanitized errors or observations
|
|
74
|
+
description: Optional for a successful install. Review snippets for private values before posting; do not upload full mail/client logs.
|
|
75
|
+
render: text
|
|
76
|
+
validations:
|
|
77
|
+
required: false
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
name: Mail MCP checks
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
pull_request:
|
|
6
|
+
|
|
7
|
+
permissions:
|
|
8
|
+
contents: read
|
|
9
|
+
|
|
10
|
+
jobs:
|
|
11
|
+
tests:
|
|
12
|
+
strategy:
|
|
13
|
+
fail-fast: false
|
|
14
|
+
matrix:
|
|
15
|
+
include:
|
|
16
|
+
- os: ubuntu-latest
|
|
17
|
+
python: '3.10'
|
|
18
|
+
- os: ubuntu-latest
|
|
19
|
+
python: '3.11'
|
|
20
|
+
- os: ubuntu-latest
|
|
21
|
+
python: '3.12'
|
|
22
|
+
# macos-latest uses arm64; hosted capacity currently prevents jobs
|
|
23
|
+
# acquiring a runner. Keep macOS checks on the supported Intel image.
|
|
24
|
+
- os: macos-15-intel
|
|
25
|
+
python: '3.12'
|
|
26
|
+
runs-on: ${{ matrix.os }}
|
|
27
|
+
timeout-minutes: 15
|
|
28
|
+
steps:
|
|
29
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
|
|
30
|
+
with:
|
|
31
|
+
persist-credentials: false
|
|
32
|
+
- uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
|
|
33
|
+
with:
|
|
34
|
+
python-version: ${{ matrix.python }}
|
|
35
|
+
enable-cache: true
|
|
36
|
+
- run: uv sync --locked
|
|
37
|
+
- name: Synthetic unit and MCP protocol tests
|
|
38
|
+
run: uv run --locked python -m unittest discover -s tests -v
|
|
39
|
+
- name: Synthetic keyword retrieval benchmark
|
|
40
|
+
run: uv run --locked python scripts/benchmark_search.py --require-recall 1 --require-precision 1 --require-no-false-positives
|
|
41
|
+
- name: Build distributable package
|
|
42
|
+
run: uv build
|
|
43
|
+
- name: Export locked installation constraints
|
|
44
|
+
run: uv export --locked --no-dev --no-emit-project --format requirements.txt --output-file "${RUNNER_TEMP}/thunderbird-constraints.txt"
|
|
45
|
+
- name: Install and exercise the wheel in a clean environment
|
|
46
|
+
run: uv run --locked python scripts/test_install.py --wheel dist/*.whl --constraints "${RUNNER_TEMP}/thunderbird-constraints.txt" --json
|
|
47
|
+
|
|
48
|
+
windows-install:
|
|
49
|
+
runs-on: windows-latest
|
|
50
|
+
timeout-minutes: 15
|
|
51
|
+
steps:
|
|
52
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
|
|
53
|
+
with:
|
|
54
|
+
persist-credentials: false
|
|
55
|
+
- uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2
|
|
56
|
+
with:
|
|
57
|
+
python-version: '3.12'
|
|
58
|
+
enable-cache: true
|
|
59
|
+
- run: uv sync --locked
|
|
60
|
+
- name: Native Windows launcher and client configuration regressions
|
|
61
|
+
run: uv run --locked python -m unittest discover -s tests -p test_windows_setup.py -v
|
|
62
|
+
- name: Native profile discovery regressions
|
|
63
|
+
run: uv run --locked python -m unittest discover -s tests -p test_profile.py -v
|
|
64
|
+
- name: Build distributable package
|
|
65
|
+
run: uv build
|
|
66
|
+
- name: Export locked installation constraints
|
|
67
|
+
run: uv export --locked --no-dev --no-emit-project --format requirements.txt --output-file "$env:RUNNER_TEMP/thunderbird-constraints.txt"
|
|
68
|
+
- name: Install and exercise the wheel on native Windows
|
|
69
|
+
run: |
|
|
70
|
+
$mailWheel = (Get-ChildItem dist/*.whl | Select-Object -First 1).FullName
|
|
71
|
+
uv run --locked python scripts/test_windows_install.py --wheel "$mailWheel" --constraints "$env:RUNNER_TEMP/thunderbird-constraints.txt"
|
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
name: Release
|
|
2
|
+
|
|
3
|
+
# Push a tag vX.Y.Z whose version matches pyproject.toml and server.json.
|
|
4
|
+
# PyPI uses trusted publishing (no stored token) through the `pypi` environment;
|
|
5
|
+
# the MCP Registry authenticates with this repository's GitHub OIDC identity.
|
|
6
|
+
|
|
7
|
+
on:
|
|
8
|
+
push:
|
|
9
|
+
tags: ["v*"]
|
|
10
|
+
|
|
11
|
+
permissions:
|
|
12
|
+
contents: read
|
|
13
|
+
|
|
14
|
+
jobs:
|
|
15
|
+
build:
|
|
16
|
+
runs-on: ubuntu-latest
|
|
17
|
+
timeout-minutes: 20
|
|
18
|
+
steps:
|
|
19
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
|
|
20
|
+
with:
|
|
21
|
+
persist-credentials: false
|
|
22
|
+
- uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
|
|
23
|
+
with:
|
|
24
|
+
python-version: '3.12'
|
|
25
|
+
- name: Tag, package and registry versions agree
|
|
26
|
+
run: |
|
|
27
|
+
tag="${GITHUB_REF_NAME#v}"
|
|
28
|
+
pkg="$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")"
|
|
29
|
+
srv="$(jq -r .version server.json)"
|
|
30
|
+
srv_pkg="$(jq -r '.packages[0].version' server.json)"
|
|
31
|
+
echo "tag=$tag pyproject=$pkg server.json=$srv/$srv_pkg"
|
|
32
|
+
if [ "$tag" != "$pkg" ] || [ "$tag" != "$srv" ] || [ "$tag" != "$srv_pkg" ]; then
|
|
33
|
+
echo "::error::Tag $GITHUB_REF_NAME does not match pyproject.toml and server.json versions"
|
|
34
|
+
exit 1
|
|
35
|
+
fi
|
|
36
|
+
- name: README carries the MCP Registry ownership marker
|
|
37
|
+
run: |
|
|
38
|
+
grep -q "mcp-name: $(jq -r .name server.json)" README.md
|
|
39
|
+
- run: uv sync --locked
|
|
40
|
+
- name: Synthetic unit and MCP protocol tests
|
|
41
|
+
run: uv run --locked python -m unittest discover -s tests -v
|
|
42
|
+
- name: Build distributable package
|
|
43
|
+
run: uv build
|
|
44
|
+
- name: Export locked installation constraints
|
|
45
|
+
run: uv export --locked --no-dev --no-emit-project --format requirements.txt --output-file "${RUNNER_TEMP}/thunderbird-constraints.txt"
|
|
46
|
+
- name: Install and exercise the wheel in a clean environment
|
|
47
|
+
run: uv run --locked python scripts/test_install.py --wheel dist/*.whl --constraints "${RUNNER_TEMP}/thunderbird-constraints.txt" --json
|
|
48
|
+
- name: Checksums
|
|
49
|
+
run: (cd dist && sha256sum -- * > "${RUNNER_TEMP}/SHA256SUMS") && mkdir sums && mv "${RUNNER_TEMP}/SHA256SUMS" sums/
|
|
50
|
+
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
|
51
|
+
with:
|
|
52
|
+
name: dist
|
|
53
|
+
path: dist/
|
|
54
|
+
if-no-files-found: error
|
|
55
|
+
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
|
|
56
|
+
with:
|
|
57
|
+
name: sums
|
|
58
|
+
path: sums/SHA256SUMS
|
|
59
|
+
if-no-files-found: error
|
|
60
|
+
|
|
61
|
+
pypi:
|
|
62
|
+
needs: build
|
|
63
|
+
runs-on: ubuntu-latest
|
|
64
|
+
timeout-minutes: 10
|
|
65
|
+
environment:
|
|
66
|
+
name: pypi
|
|
67
|
+
url: https://pypi.org/project/thunderbird-mcp/
|
|
68
|
+
permissions:
|
|
69
|
+
id-token: write
|
|
70
|
+
steps:
|
|
71
|
+
- uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
|
|
72
|
+
with:
|
|
73
|
+
name: dist
|
|
74
|
+
path: dist/
|
|
75
|
+
- uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
|
|
76
|
+
|
|
77
|
+
mcp-registry:
|
|
78
|
+
needs: pypi
|
|
79
|
+
runs-on: ubuntu-latest
|
|
80
|
+
timeout-minutes: 15
|
|
81
|
+
permissions:
|
|
82
|
+
id-token: write
|
|
83
|
+
contents: read
|
|
84
|
+
env:
|
|
85
|
+
MCP_PUBLISHER_VERSION: v1.8.9
|
|
86
|
+
steps:
|
|
87
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
|
|
88
|
+
with:
|
|
89
|
+
persist-credentials: false
|
|
90
|
+
- uses: sigstore/cosign-installer@756fe2d284c7292c4e9b62c8a28f1e5629c59532 # v4.1.3
|
|
91
|
+
- name: Download and verify mcp-publisher
|
|
92
|
+
run: |
|
|
93
|
+
set -euo pipefail
|
|
94
|
+
archive="mcp-publisher_linux_amd64.tar.gz"
|
|
95
|
+
base_url="https://github.com/modelcontextprotocol/registry/releases/download/${MCP_PUBLISHER_VERSION}"
|
|
96
|
+
curl --fail --location --silent --show-error --output "$archive" "$base_url/$archive"
|
|
97
|
+
curl --fail --location --silent --show-error --output "$archive.sigstore.json" "$base_url/$archive.sigstore.json"
|
|
98
|
+
cosign verify-blob \
|
|
99
|
+
--bundle "$archive.sigstore.json" \
|
|
100
|
+
--certificate-identity "https://github.com/modelcontextprotocol/registry/.github/workflows/release.yml@refs/tags/${MCP_PUBLISHER_VERSION}" \
|
|
101
|
+
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
|
|
102
|
+
"$archive"
|
|
103
|
+
tar xzf "$archive" mcp-publisher
|
|
104
|
+
rm -f "$archive" "$archive.sigstore.json"
|
|
105
|
+
- name: Wait for the release on PyPI
|
|
106
|
+
run: |
|
|
107
|
+
version="${GITHUB_REF_NAME#v}"
|
|
108
|
+
for _ in $(seq 1 30); do
|
|
109
|
+
if curl --fail --silent --output /dev/null "https://pypi.org/pypi/thunderbird-mcp/${version}/json"; then
|
|
110
|
+
exit 0
|
|
111
|
+
fi
|
|
112
|
+
sleep 10
|
|
113
|
+
done
|
|
114
|
+
echo "::error::thunderbird-mcp ${version} did not appear on PyPI within five minutes"
|
|
115
|
+
exit 1
|
|
116
|
+
- run: ./mcp-publisher validate server.json
|
|
117
|
+
- run: ./mcp-publisher login github-oidc
|
|
118
|
+
- run: ./mcp-publisher publish
|
|
119
|
+
|
|
120
|
+
github-release:
|
|
121
|
+
needs: pypi
|
|
122
|
+
runs-on: ubuntu-latest
|
|
123
|
+
timeout-minutes: 10
|
|
124
|
+
permissions:
|
|
125
|
+
contents: write
|
|
126
|
+
steps:
|
|
127
|
+
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
|
|
128
|
+
with:
|
|
129
|
+
persist-credentials: false
|
|
130
|
+
- uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
|
|
131
|
+
with:
|
|
132
|
+
name: dist
|
|
133
|
+
path: dist/
|
|
134
|
+
- uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
|
|
135
|
+
with:
|
|
136
|
+
name: sums
|
|
137
|
+
path: sums/
|
|
138
|
+
- name: Create the GitHub release
|
|
139
|
+
env:
|
|
140
|
+
GH_TOKEN: ${{ github.token }}
|
|
141
|
+
run: |
|
|
142
|
+
version="${GITHUB_REF_NAME#v}"
|
|
143
|
+
awk -v v="$version" '$0 ~ "^## " v "( |$)" {on=1; next} /^## / && on {exit} on' CHANGELOG.md > notes.md
|
|
144
|
+
test -s notes.md || echo "See CHANGELOG.md." > notes.md
|
|
145
|
+
gh release create "$GITHUB_REF_NAME" dist/* sums/SHA256SUMS \
|
|
146
|
+
--repo "$GITHUB_REPOSITORY" --title "Thunderbird MCP $version" --notes-file notes.md --verify-tag
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
.venv/
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.pyc
|
|
4
|
+
# the built mail index (can be large; rebuilt from Thunderbird on demand)
|
|
5
|
+
*.sqlite
|
|
6
|
+
*.sqlite-*
|
|
7
|
+
embed.log
|
|
8
|
+
web-test.log
|
|
9
|
+
moves.jsonl
|
|
10
|
+
*.sqlite.bak-*
|
|
11
|
+
backups/
|
|
12
|
+
exports/
|
|
13
|
+
*.log
|
|
14
|
+
.pytest_cache/
|
|
15
|
+
.ruff_cache/
|
|
16
|
+
# Local retrieval examples refer to the owner's real mailbox.
|
|
17
|
+
/eval/
|
|
18
|
+
*.eml
|
|
19
|
+
*.mbox
|
|
20
|
+
*.msf
|
|
21
|
+
.env
|
|
22
|
+
.env.*
|
|
23
|
+
!.env.example
|
|
24
|
+
*.thunderbird-backup-*
|
|
25
|
+
/dist/
|
|
26
|
+
/build/
|
|
27
|
+
*.egg-info/
|
|
28
|
+
*.jsonl
|
|
29
|
+
/client-test-reports/
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.4.1 — 2026-11-17
|
|
4
|
+
|
|
5
|
+
Distribution only; the mail server and its 56 tools are unchanged from 0.4.0.
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- Published on [PyPI](https://pypi.org/project/thunderbird-mcp/) as `thunderbird-mcp`:
|
|
10
|
+
`uv tool install --python 3.12 thunderbird-mcp`, then `thunderbird-mcp-setup --apply`.
|
|
11
|
+
- Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/) as
|
|
12
|
+
`io.github.simonjamescarroll/thunderbirdmcp` (`server.json`).
|
|
13
|
+
- Tag-driven release workflow: tests and a clean wheel install, PyPI trusted publishing,
|
|
14
|
+
MCP Registry publication through GitHub OIDC, and a GitHub release with `SHA256SUMS`.
|
|
15
|
+
|
|
16
|
+
### Changed
|
|
17
|
+
|
|
18
|
+
- Project links follow the GitHub owner rename to `simonjamescarroll`.
|
|
19
|
+
|
|
20
|
+
## 0.4.0 — 2026-11-02
|
|
21
|
+
|
|
22
|
+
This release implements the twenty-item [roadmap](ROADMAP.md), with **56 mail
|
|
23
|
+
MCP tools** and the same stdio integrations. See the [workflow guide](docs/workflows.md)
|
|
24
|
+
for configuration requirements and bounded behavior. Native desktop features
|
|
25
|
+
use a separately configured companion; they are not counted in these 56 tools.
|
|
26
|
+
|
|
27
|
+
### Added
|
|
28
|
+
|
|
29
|
+
- Enforced read-only/draft-only/full profiles, tool allowlists, account/file
|
|
30
|
+
boundaries and direct-call protection. The same rules govern services.
|
|
31
|
+
- Revision-checked draft editing/discard/reconciliation, forwards with explicit
|
|
32
|
+
recipients/attachments, HTML/plain alternatives, inline parts and configured
|
|
33
|
+
sender/SMTP identities. Existing exact-MIME delivery claims remain shared.
|
|
34
|
+
- Bounded live read/star/keyword/Gmail-label changes; copy/move/archive/trash/
|
|
35
|
+
restore and explicitly confirmed scoped permanent deletion; special-use
|
|
36
|
+
discovery and ordinary-folder rename/empty deletion. Previews and per-item
|
|
37
|
+
uncertain outcomes remain visible, including when cancellation is requested.
|
|
38
|
+
- Stable search continuation snapshots, omitted-match and filter/term
|
|
39
|
+
diagnostics, bounded live multi-scope search and partial-failure reporting.
|
|
40
|
+
- Reviewed batch exports with frozen bytes, collision-free filenames,
|
|
41
|
+
checksums, no overwrite and explicit resume/recovery.
|
|
42
|
+
- Durable operation history, cancellation before mail effects, new-mail
|
|
43
|
+
events with resume cursors and optional bounded IMAP IDLE. Explicit foreground
|
|
44
|
+
service commands are installed without enabling background activity.
|
|
45
|
+
- Approved revision-bound delivery scheduling through SMTP, Gmail or Graph,
|
|
46
|
+
with timezones, persistent claims and no automatic uncertain-delivery retry.
|
|
47
|
+
- BYO browser OAuth enrollment with PKCE, separate Gmail/Graph credentials and
|
|
48
|
+
API adapters for search/read/threads/triage/draft handoff/sending. API scopes
|
|
49
|
+
remain distinct from Gmail's broad IMAP/SMTP scope.
|
|
50
|
+
- Authenticated stateless Streamable HTTP, private hash-only bearer config,
|
|
51
|
+
principal-owned persisted state, explicit account/file roots and loopback
|
|
52
|
+
default. Host/Origin and request-size checks apply before dispatch.
|
|
53
|
+
- Bounded authentication-header evidence and header-based follow-up candidates;
|
|
54
|
+
neither automatically trusts a sender nor sends reminders.
|
|
55
|
+
- Incremental read-only Maildir indexing retaining existing references and IDs.
|
|
56
|
+
Optional Tesseract OCR supports images/scanned PDFs with explicit installed
|
|
57
|
+
languages, no automatic downloads and byte/page/pixel/time limits.
|
|
58
|
+
- Native Windows profile/data discovery and launchers, plus a Windows installed
|
|
59
|
+
wheel/stdio CI job. A pinned separate native Thunderbird bridge covers
|
|
60
|
+
contacts, calendars/tasks, filters and settings in an isolated environment.
|
|
61
|
+
- `tbmail call` exposes the same typed MCP tools from terminal sessions;
|
|
62
|
+
friendly draft/forward/triage/auth commands and service/HTTP entrypoints are
|
|
63
|
+
included. Documentation now separates capabilities from verification scope.
|
|
64
|
+
|
|
65
|
+
- Add `save_draft_to_thunderbird` and `tbmail save-draft <draft-id>` to save a local
|
|
66
|
+
draft in the account's Thunderbird IMAP Drafts folder without sending. Bcc,
|
|
67
|
+
captured attachments, and reply threading are preserved. Repeat or interrupted
|
|
68
|
+
saves cannot append automatically again, and the local snapshot cannot be sent
|
|
69
|
+
after it is handed to Thunderbird for editing. Local and cross-account Drafts
|
|
70
|
+
destinations are rejected.
|
|
71
|
+
|
|
72
|
+
### Verification scope
|
|
73
|
+
|
|
74
|
+
Regression tests use generated messages, isolated homes and mocked transports.
|
|
75
|
+
Actual MCP stdio/HTTP protocol checks cover restrictive profiles, account and
|
|
76
|
+
file isolation, draft revisions and cross-session references. Native Windows
|
|
77
|
+
CI exercises a wheel installation, command launchers and synthetic mail through
|
|
78
|
+
the real stdio protocol. An isolated real Tesseract/Poppler smoke extracted text
|
|
79
|
+
from synthetic PNG and image-only PDF documents. The companion's pinned
|
|
80
|
+
catalogue/stdio and configuration were checked separately.
|
|
81
|
+
|
|
82
|
+
Real provider consent, deliveries, mailbox mutations/IDLE and interactive
|
|
83
|
+
Thunderbird-addon operations were not performed with the user's mail. Provider
|
|
84
|
+
application/tenant consent, installed OCR engines/languages and native addon
|
|
85
|
+
installation remain explicit configuration requirements.
|
|
86
|
+
|
|
87
|
+
## 0.3.1 — 2026-11-02
|
|
88
|
+
|
|
89
|
+
This release improves installation and makes the mail workflows easier to
|
|
90
|
+
evaluate independently. The mail features introduced in 0.3.0 remain available.
|
|
91
|
+
|
|
92
|
+
### Added
|
|
93
|
+
|
|
94
|
+
- An MIT license, package metadata, and links to documentation, source, issues,
|
|
95
|
+
and release history. Source archives explicitly include project code,
|
|
96
|
+
documentation, tests, and the dependency lock.
|
|
97
|
+
- An offline [synthetic mail demo](docs/demo.md) that runs separate terminal
|
|
98
|
+
processes through attachment search, a reusable reference, message and thread
|
|
99
|
+
reads, attachment text extraction, reply drafting, and an unsent preview.
|
|
100
|
+
Its generated SVG shows selected fields from verified command output.
|
|
101
|
+
- A clean-install runner for both a fresh virtual environment and `uv tool
|
|
102
|
+
install`. It exercises packaged commands, configuration setup, user data paths,
|
|
103
|
+
and an actual MCP stdio workflow with generated mail. CI now includes this
|
|
104
|
+
package check using dependencies constrained by the lockfile.
|
|
105
|
+
- A dedicated [installation guide](docs/installation.md) covering checkout and
|
|
106
|
+
wheel installation, credentials, data locations, and troubleshooting.
|
|
107
|
+
- Contribution guidance and public issue forms for successful installations,
|
|
108
|
+
partial installations, and reproducible bugs. Reports request software
|
|
109
|
+
versions and sanitized steps rather than private mail or credentials.
|
|
110
|
+
|
|
111
|
+
### Fixed
|
|
112
|
+
|
|
113
|
+
- Setup works from an installed wheel without requiring a source checkout's
|
|
114
|
+
`.venv`. Existing entrypoint links managed by `uv tool` are preserved, and
|
|
115
|
+
setup remains idempotent.
|
|
116
|
+
- Installed packages keep private index and outbox data in the user's data
|
|
117
|
+
directory rather than `site-packages`. Source checkouts retain their existing
|
|
118
|
+
default data location, and explicit database overrides remain available.
|
|
119
|
+
- Thunderbird profile discovery includes macOS and accepts literal percent signs
|
|
120
|
+
in profile paths. Missing or malformed profiles produce actionable guidance.
|
|
121
|
+
- Package console entrypoints initialize the desktop session environment used
|
|
122
|
+
for keyring access, as the generated launchers already did.
|
|
123
|
+
|
|
124
|
+
### Verification scope
|
|
125
|
+
|
|
126
|
+
The demo and installed-package checks use generated mail and isolated homes;
|
|
127
|
+
mail application processes block network access and use a disabled keyring.
|
|
128
|
+
They do not establish provider authentication or an actual desktop installation.
|
|
129
|
+
The v0.3.1 wheel passed both fresh-venv and `uv tool` installation checks on
|
|
130
|
+
Linux/Python 3.11, including client setup and an actual MCP search/read/reference,
|
|
131
|
+
attachment-search, and unsent-draft workflow with synthetic mail.
|
|
132
|
+
The [CI workflow](https://github.com/simonjamescarroll/thunderbirdmcp/actions/workflows/checks.yml)
|
|
133
|
+
runs synthetic tests, the keyword benchmark, builds, and clean-install checks on
|
|
134
|
+
Linux and macOS. The release's CI result is separate from the v0.3.0 results
|
|
135
|
+
recorded below.
|
|
136
|
+
|
|
137
|
+
Independent installation reports are invited through the new issue form; no
|
|
138
|
+
external testers or their results are implied. A complete macOS desktop
|
|
139
|
+
integration, native Windows deployment, and provider browser OAuth consent
|
|
140
|
+
remain outside the verified scope. Actual Codex/Claude/OpenCode smoke checks
|
|
141
|
+
are opt-in checks with model accounts, not part of synthetic CI.
|
|
142
|
+
|
|
143
|
+
## 0.3.0 — 2026-11-02
|
|
144
|
+
|
|
145
|
+
### Added
|
|
146
|
+
|
|
147
|
+
- Live IMAP search, message and conversation reads, references, and attachment
|
|
148
|
+
access without waiting for Thunderbird's local download. Reads use readonly
|
|
149
|
+
selection and `BODY.PEEK`; references check the account, folder, UIDVALIDITY,
|
|
150
|
+
and UID before returning mail.
|
|
151
|
+
- Local text extraction and search for PDF, DOCX, XLSX, PPTX, text, HTML, and XML
|
|
152
|
+
attachments, with explicit unsupported/encrypted/error statuses and resource
|
|
153
|
+
limits. `get_attachment_text` and `tbmail attachment-text` read one attachment
|
|
154
|
+
without exporting it.
|
|
155
|
+
- Account selection for search, mail operations, and drafts; scoped password
|
|
156
|
+
storage; and OAuth2 token import, refresh, and XOAUTH2 authentication.
|
|
157
|
+
- A synthetic retrieval benchmark and Linux/macOS CI covering the unit suite,
|
|
158
|
+
keyword benchmark, and package build.
|
|
159
|
+
- Documentation for reconnecting Claude Code and OpenCode in existing sessions
|
|
160
|
+
and reloading Codex app-server MCP connections while preserving conversations.
|
|
161
|
+
|
|
162
|
+
### Changed
|
|
163
|
+
|
|
164
|
+
- Index schema v3 stores attachment extraction metadata and text. Upgrades
|
|
165
|
+
preserve indexed messages and references, rebuild derived search data, and
|
|
166
|
+
backfill attachment text during reindexing.
|
|
167
|
+
- Reply drafts infer the original account when possible and reject ambiguous
|
|
168
|
+
account selection. Saved drafts retain the account used when prepared.
|
|
169
|
+
- Live references work with the existing read, citation, thread, reply, and
|
|
170
|
+
export tools. They expire if a message moves or its mailbox/account identity
|
|
171
|
+
changes; local references remain the choice for citations across moves.
|
|
172
|
+
|
|
173
|
+
### Verified
|
|
174
|
+
|
|
175
|
+
- The 162-test synthetic suite, keyword benchmark, and package builds passed
|
|
176
|
+
the Linux Python 3.10–3.12 and macOS Python 3.12 matrix in
|
|
177
|
+
[GitHub Actions](https://github.com/simonjamescarroll/thunderbirdmcp/actions/runs/41479433495).
|
|
178
|
+
- Maintainer checks on Linux exercised actual Codex, Claude Code, and OpenCode
|
|
179
|
+
with GLM tool calls against synthetic mail, existing-session reconnects,
|
|
180
|
+
readonly live IMAP access with unchanged read flags, and attachment retrieval.
|
|
181
|
+
These checks did not send mail.
|
|
182
|
+
|
|
183
|
+
### Known boundaries
|
|
184
|
+
|
|
185
|
+
- macOS CI is synthetic coverage, not verification of a complete Thunderbird
|
|
186
|
+
desktop installation. Windows deployment is unverified.
|
|
187
|
+
- OAuth imports tokens from an application you authorize. There is no browser
|
|
188
|
+
consent flow or reuse of Thunderbird's OAuth client registration. Provider
|
|
189
|
+
policies and consent have not been established by mocked protocol tests.
|
|
190
|
+
- Live search uses server text filters in one folder; local search supplies
|
|
191
|
+
semantic ranking and extracted attachment text. The small synthetic benchmark
|
|
192
|
+
does not establish superiority over other mail MCPs.
|
|
193
|
+
- Messages without Message-ID use a fallback based on indexed headers and
|
|
194
|
+
text. Identical text with different attachments can share a reference;
|
|
195
|
+
numeric IDs do not remove all ambiguity after mailbox compaction.
|