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.
Files changed (100) hide show
  1. thunderbird_mcp-0.4.1/.github/ISSUE_TEMPLATE/bug-report.yml +53 -0
  2. thunderbird_mcp-0.4.1/.github/ISSUE_TEMPLATE/config.yml +8 -0
  3. thunderbird_mcp-0.4.1/.github/ISSUE_TEMPLATE/installation-feedback.yml +77 -0
  4. thunderbird_mcp-0.4.1/.github/workflows/checks.yml +71 -0
  5. thunderbird_mcp-0.4.1/.github/workflows/release.yml +146 -0
  6. thunderbird_mcp-0.4.1/.gitignore +29 -0
  7. thunderbird_mcp-0.4.1/CHANGELOG.md +195 -0
  8. thunderbird_mcp-0.4.1/CONTRIBUTING.md +142 -0
  9. thunderbird_mcp-0.4.1/LICENSE +21 -0
  10. thunderbird_mcp-0.4.1/PKG-INFO +591 -0
  11. thunderbird_mcp-0.4.1/README.md +555 -0
  12. thunderbird_mcp-0.4.1/ROADMAP.md +75 -0
  13. thunderbird_mcp-0.4.1/docs/README.md +26 -0
  14. thunderbird_mcp-0.4.1/docs/comparison.md +169 -0
  15. thunderbird_mcp-0.4.1/docs/demo.md +37 -0
  16. thunderbird_mcp-0.4.1/docs/demo.svg +41 -0
  17. thunderbird_mcp-0.4.1/docs/faq.md +146 -0
  18. thunderbird_mcp-0.4.1/docs/implementation-status.md +69 -0
  19. thunderbird_mcp-0.4.1/docs/installation.md +220 -0
  20. thunderbird_mcp-0.4.1/docs/native-integration.md +104 -0
  21. thunderbird_mcp-0.4.1/docs/repository-traffic.md +53 -0
  22. thunderbird_mcp-0.4.1/docs/workflows.md +243 -0
  23. thunderbird_mcp-0.4.1/pyproject.toml +73 -0
  24. thunderbird_mcp-0.4.1/scripts/benchmark_search.py +220 -0
  25. thunderbird_mcp-0.4.1/scripts/demo.py +269 -0
  26. thunderbird_mcp-0.4.1/scripts/repo_traffic.py +140 -0
  27. thunderbird_mcp-0.4.1/scripts/setup_native_bridge.py +183 -0
  28. thunderbird_mcp-0.4.1/scripts/test_clients.py +227 -0
  29. thunderbird_mcp-0.4.1/scripts/test_install.py +315 -0
  30. thunderbird_mcp-0.4.1/scripts/test_windows_install.py +144 -0
  31. thunderbird_mcp-0.4.1/systemd/mail-index.service +12 -0
  32. thunderbird_mcp-0.4.1/systemd/mail-index.timer +9 -0
  33. thunderbird_mcp-0.4.1/systemd/mail-search.service +23 -0
  34. thunderbird_mcp-0.4.1/systemd/thunderbird-repo-traffic.service +13 -0
  35. thunderbird_mcp-0.4.1/systemd/thunderbird-repo-traffic.timer +11 -0
  36. thunderbird_mcp-0.4.1/tests/test_accounts.py +184 -0
  37. thunderbird_mcp-0.4.1/tests/test_attachments.py +131 -0
  38. thunderbird_mcp-0.4.1/tests/test_automation.py +279 -0
  39. thunderbird_mcp-0.4.1/tests/test_benchmark.py +35 -0
  40. thunderbird_mcp-0.4.1/tests/test_cli.py +170 -0
  41. thunderbird_mcp-0.4.1/tests/test_client_smoke.py +44 -0
  42. thunderbird_mcp-0.4.1/tests/test_demo.py +98 -0
  43. thunderbird_mcp-0.4.1/tests/test_enrollment.py +135 -0
  44. thunderbird_mcp-0.4.1/tests/test_imap.py +75 -0
  45. thunderbird_mcp-0.4.1/tests/test_index.py +254 -0
  46. thunderbird_mcp-0.4.1/tests/test_insights.py +47 -0
  47. thunderbird_mcp-0.4.1/tests/test_install.py +119 -0
  48. thunderbird_mcp-0.4.1/tests/test_integration.py +192 -0
  49. thunderbird_mcp-0.4.1/tests/test_live.py +280 -0
  50. thunderbird_mcp-0.4.1/tests/test_mailbox.py +163 -0
  51. thunderbird_mcp-0.4.1/tests/test_maildir.py +178 -0
  52. thunderbird_mcp-0.4.1/tests/test_messages.py +150 -0
  53. thunderbird_mcp-0.4.1/tests/test_native_bridge.py +176 -0
  54. thunderbird_mcp-0.4.1/tests/test_oauth.py +172 -0
  55. thunderbird_mcp-0.4.1/tests/test_ocr.py +145 -0
  56. thunderbird_mcp-0.4.1/tests/test_operations.py +135 -0
  57. thunderbird_mcp-0.4.1/tests/test_outgoing.py +673 -0
  58. thunderbird_mcp-0.4.1/tests/test_pagination_exports.py +71 -0
  59. thunderbird_mcp-0.4.1/tests/test_policy.py +144 -0
  60. thunderbird_mcp-0.4.1/tests/test_profile.py +79 -0
  61. thunderbird_mcp-0.4.1/tests/test_providers.py +268 -0
  62. thunderbird_mcp-0.4.1/tests/test_remote.py +84 -0
  63. thunderbird_mcp-0.4.1/tests/test_remote_boundaries.py +141 -0
  64. thunderbird_mcp-0.4.1/tests/test_runtime.py +113 -0
  65. thunderbird_mcp-0.4.1/tests/test_search.py +155 -0
  66. thunderbird_mcp-0.4.1/tests/test_server.py +215 -0
  67. thunderbird_mcp-0.4.1/tests/test_service.py +51 -0
  68. thunderbird_mcp-0.4.1/tests/test_windows_setup.py +105 -0
  69. thunderbird_mcp-0.4.1/tests/test_workflow_integration.py +144 -0
  70. thunderbird_mcp-0.4.1/thunderbird_mcp/__init__.py +8 -0
  71. thunderbird_mcp-0.4.1/thunderbird_mcp/attachments.py +302 -0
  72. thunderbird_mcp-0.4.1/thunderbird_mcp/automation.py +441 -0
  73. thunderbird_mcp-0.4.1/thunderbird_mcp/cli.py +450 -0
  74. thunderbird_mcp-0.4.1/thunderbird_mcp/enrollment.py +226 -0
  75. thunderbird_mcp-0.4.1/thunderbird_mcp/exports.py +189 -0
  76. thunderbird_mcp-0.4.1/thunderbird_mcp/imap.py +353 -0
  77. thunderbird_mcp-0.4.1/thunderbird_mcp/index.py +547 -0
  78. thunderbird_mcp-0.4.1/thunderbird_mcp/insights.py +156 -0
  79. thunderbird_mcp-0.4.1/thunderbird_mcp/live.py +506 -0
  80. thunderbird_mcp-0.4.1/thunderbird_mcp/mailbox.py +295 -0
  81. thunderbird_mcp-0.4.1/thunderbird_mcp/maildir.py +206 -0
  82. thunderbird_mcp-0.4.1/thunderbird_mcp/messages.py +448 -0
  83. thunderbird_mcp-0.4.1/thunderbird_mcp/oauth.py +296 -0
  84. thunderbird_mcp-0.4.1/thunderbird_mcp/ocr.py +240 -0
  85. thunderbird_mcp-0.4.1/thunderbird_mcp/operations.py +288 -0
  86. thunderbird_mcp-0.4.1/thunderbird_mcp/outgoing.py +1245 -0
  87. thunderbird_mcp-0.4.1/thunderbird_mcp/pagination.py +146 -0
  88. thunderbird_mcp-0.4.1/thunderbird_mcp/policy.py +336 -0
  89. thunderbird_mcp-0.4.1/thunderbird_mcp/profile.py +151 -0
  90. thunderbird_mcp-0.4.1/thunderbird_mcp/providers.py +543 -0
  91. thunderbird_mcp-0.4.1/thunderbird_mcp/remote.py +185 -0
  92. thunderbird_mcp-0.4.1/thunderbird_mcp/runtime.py +62 -0
  93. thunderbird_mcp-0.4.1/thunderbird_mcp/search.py +541 -0
  94. thunderbird_mcp-0.4.1/thunderbird_mcp/server.py +756 -0
  95. thunderbird_mcp-0.4.1/thunderbird_mcp/service.py +73 -0
  96. thunderbird_mcp-0.4.1/thunderbird_mcp/setup.py +379 -0
  97. thunderbird_mcp-0.4.1/thunderbird_mcp/status.py +115 -0
  98. thunderbird_mcp-0.4.1/thunderbird_mcp/web.html +173 -0
  99. thunderbird_mcp-0.4.1/thunderbird_mcp/web.py +109 -0
  100. 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.