Individual skill
agent-mail
MCP Agent Mail - Mail-like coordination layer for multi-agent workflows. Identities, inbox/outbox, file reservations, contact policies, threaded messaging, pre-commit guard, Human Overseer, static exports, disaster recovery. Git+SQLite backed. Python/FastMCP.
SKILL.md
Source commit 9138f34b1ed220235dbfeaa3f1fc9fe4444f4e72
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 2,234
- Repository last updated
- Nov 5, 2026
- License
- NOASSERTION
Observed agent integration: claude-code, codex
- ai-agents Repository topic
- coordination Repository topic
- fastmcp Repository topic
- mcp Repository topic
- python Repository topic
- engineering Derived category
- data Derived category
- data-databases Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
.beads/.br-db-write-15a47e2e52cd5574494ec0d6.lockasset · 0 bytes.beads/.br-jsonl-write-698c797d9b28b25a18cbe556.lockasset · 0 bytes.beads/.br-jsonl-write-780070d67b215fe71e5db7a9.lockasset · 0 bytes.beads/.gitignoreasset · 1,035 bytes.beads/README.mddoc · 2,250 bytes.beads/beads.jsonlasset · 28,246 bytes.beads/config.yamlasset · 17 bytes.beads/interactions.jsonlasset · 0 bytes.beads/issues.jsonlasset · 234,098 bytes.beads/metadata.jsonasset · 62 bytes.beads/testing-tasks-v2.mddoc · 16,235 bytes.beads/testing-tasks.mddoc · 20,418 bytes.claude/settings.jsonasset · 1,327 bytes.claude/settings.json.templateasset · 1,557 bytes.codex/config.tomlasset · 421 bytes.dockerignoreasset · 570 bytes.env.exampleasset · 1,356 bytes.envrcasset · 26 bytes.gitattributesasset · 70 bytes.githooks/pre-commitruns · 4,256 bytes.github/workflows/acfs-checksums-dispatch.ymlasset · 1,149 bytes.github/workflows/ci.ymlasset · 3,164 bytes.github/workflows/nightly.ymlasset · 1,079 bytes.github/workflows/notify-acfs.ymlasset · 2,869 bytes.github/workflows/release.ymlasset · 2,263 bytes.gitignoreasset · 4,181 bytes.mcp.jsonasset · 199 bytesAGENTS.mddoc · 33,239 bytesCHANGELOG.mddoc · 45,675 bytesDockerfileruns · 6,410 bytesLICENSEasset · 3,939 bytesMakefileruns · 434 bytesREADME.mddoc · 141,964 bytesSKILL.mdcore · 13,599 bytesSKILL.mdcore · 13,599 bytesSKILL.mdcore · 13,599 bytesSKILL.mdcore · 13,599 bytesSKILL.mdcore · 13,599 bytesSKILL.mdcore · 13,599 bytesSKILL.mdcore · 13,599 bytescline.mcp.jsonasset · 259 bytescodex.mcp.jsonasset · 186 bytescompose.yamlasset · 344 bytescursor.mcp.jsonasset · 186 bytesdeploy/capabilities/agent_capabilities.example.yamlasset · 716 bytesdeploy/capabilities/agent_capabilities.jsonasset · 496 bytesdeploy/gunicorn.conf.pyruns · 758 bytesdeploy/logrotate/mcp-agent-mailasset · 290 bytesdeploy/observability/prometheus_rules.sample.ymlasset · 2,128 bytesdeploy/systemd/mcp-agent-mail.serviceasset · 424 bytesdocker-compose.ymlasset · 582 bytesdocs/GUIDE_TO_OPTIMAL_MCP_SERVER_DESIGN.mddoc · 8,709 bytesdocs/IDENTITY_CONTRACT.mddoc · 7,651 bytesdocs/adr/002-rust-optimization-analysis.mddoc · 6,014 bytesdocs/adr/README.mddoc · 1,429 bytesdocs/deployment_samples/cloudflare-pages-example.tomlasset · 362 bytesdocs/deployment_samples/github-actions-share.ymlasset · 1,146 bytesdocs/observability.mddoc · 2,028 bytesdocs/operations_alignment_checklist.mddoc · 2,683 bytesdocs/performance/baseline-metrics.mddoc · 2,355 bytesdocs/planning/AGENT_FRIENDLINESS_REPORT.mddoc · 4,811 bytesdocs/planning/PLAN_TO_ENABLE_EASY_AND_SECURE_SHARING_OF_AGENT_MAILBOX.mddoc · 23,413 bytesdocs/planning/PLAN_TO_NON_DISRUPTIVELY_INTEGRATE_WITH_THE_GIT_WORKTREE_APPROACH.mddoc · 71,850 bytesdocs/planning/project_idea_and_guide.mddoc · 42,379 bytesdocs/research/globtrie-analysis.mddoc · 6,947 bytesexamples/client_bootstrap.pyruns · 3,543 bytesgemini.mcp.jsonasset · 168 bytesgh_og_share_image.pngasset · 190,152 bytespyproject.tomlasset · 3,214 bytesrevoked-signing-77c6e768.pubasset · 44 bytesscreenshots/output/agent_mail_showcase.gifasset · 3,198,043 bytesscreenshots/output/agent_mail_showcase.mp4asset · 1,145,000 bytesscreenshots/output/palette_2k.pngasset · 1,003 bytesscreenshots/webp/agent_mail_overview.webpasset · 636,964 bytesscreenshots/webp/backend_frontend_coordination_terminal.webpasset · 284,814 bytesscreenshots/webp/backend_frontend_harmonization_terminal.webpasset · 314,474 bytesscreenshots/webp/file_reservations_view.webpasset · 148,370 bytesscreenshots/webp/mcp_server_console_output.webpasset · 373,532 bytesscreenshots/webp/unified_inbox_view_01.webpasset · 249,162 bytesscreenshots/webp/unified_inbox_view_02.webpasset · 249,712 bytesscripts/automatically_detect_all_installed_coding_agents_and_install_mcp_agent_mail_in_all.shruns · 7,380 bytesscripts/bootstrap.shruns · 1,973 bytesscripts/check_console_environment.pyruns · 1,744 bytesscripts/deploy.shruns · 1,796 bytesscripts/hooks/check_inbox.shruns · 7,599 bytesscripts/hooks/codex_notify.shruns · 6,311 bytesscripts/identity-resolve.shruns · 5,619 bytesscripts/identity-write.shruns · 3,792 bytesscripts/install.shruns · 34,625 bytesscripts/integrate_claude_code.shruns · 16,657 bytesscripts/integrate_cline.shruns · 4,902 bytesscripts/integrate_codex_cli.shruns · 18,632 bytesscripts/integrate_cursor.shruns · 4,751 bytesscripts/integrate_factory_droid.shruns · 12,173 bytesscripts/integrate_gemini_cli.shruns · 15,151 bytesscripts/integrate_github_copilot.shruns · 8,360 bytesscripts/integrate_opencode.shruns · 6,966 bytesscripts/integrate_windsurf.shruns · 4,875 bytesscripts/integration_showcase.pyruns · 34,533 bytesscripts/lib.shruns · 33,136 bytesscripts/run_server_with_token.shruns · 2,142 bytesscripts/share_to_github_pages.pyruns · 57,653 bytesscripts/test_bd_path_snippet_rewrite.shruns · 2,382 bytesscripts/test_endpoints.shruns · 1,089 bytesscripts/test_guard.shruns · 2,456 bytesscripts/test_rich_output.pyruns · 5,652 bytesscripts/test_run_server_directly.shruns · 526 bytesscripts/update_sqlite_vendor.pyruns · 2,928 bytessrc/mcp_agent_mail/__init__.pyruns · 620 bytessrc/mcp_agent_mail/__main__.pyruns · 422 bytessrc/mcp_agent_mail/app.pyruns · 650,935 bytessrc/mcp_agent_mail/cli.pyruns · 253,902 bytessrc/mcp_agent_mail/config.pyruns · 26,825 bytessrc/mcp_agent_mail/db.pyruns · 40,169 bytessrc/mcp_agent_mail/guard.pyruns · 41,099 bytessrc/mcp_agent_mail/http.pyruns · 210,672 bytessrc/mcp_agent_mail/llm.pyruns · 10,464 bytessrc/mcp_agent_mail/models.pyruns · 9,861 bytessrc/mcp_agent_mail/rich_logger.pyruns · 36,301 bytessrc/mcp_agent_mail/share.pyruns · 94,626 bytessrc/mcp_agent_mail/storage.pyruns · 153,085 bytessrc/mcp_agent_mail/templates/archive_activity.htmlasset · 9,447 bytessrc/mcp_agent_mail/templates/archive_browser.htmlasset · 8,243 bytessrc/mcp_agent_mail/templates/archive_commit.htmlasset · 10,865 bytessrc/mcp_agent_mail/templates/archive_guide.htmlasset · 29,726 bytessrc/mcp_agent_mail/templates/archive_network.htmlasset · 5,467 bytessrc/mcp_agent_mail/templates/archive_time_travel.htmlasset · 11,253 bytessrc/mcp_agent_mail/templates/archive_timeline.htmlasset · 4,506 bytessrc/mcp_agent_mail/templates/base.htmlasset · 141,205 bytessrc/mcp_agent_mail/templates/error.htmlasset · 3,585 bytessrc/mcp_agent_mail/templates/mail_attachments.htmlasset · 7,872 bytessrc/mcp_agent_mail/templates/mail_claims.htmlasset · 12,817 bytessrc/mcp_agent_mail/templates/mail_file_reservations.htmlasset · 826 bytessrc/mcp_agent_mail/templates/mail_inbox.htmlasset · 32,826 bytessrc/mcp_agent_mail/templates/mail_index.htmlasset · 44,385 bytessrc/mcp_agent_mail/templates/mail_message.htmlasset · 20,073 bytessrc/mcp_agent_mail/templates/mail_project.htmlasset · 38,087 bytessrc/mcp_agent_mail/templates/mail_search.htmlasset · 18,068 bytessrc/mcp_agent_mail/templates/mail_search_snippet.htmlasset · 715 bytessrc/mcp_agent_mail/templates/mail_thread.htmlasset · 12,509 bytessrc/mcp_agent_mail/templates/mail_threads.htmlasset · 5,201 bytessrc/mcp_agent_mail/templates/mail_unified_inbox.htmlasset · 67,490 bytessrc/mcp_agent_mail/templates/overseer_compose.htmlasset · 33,945 bytessrc/mcp_agent_mail/utils.pyruns · 6,231 bytessrc/mcp_agent_mail/viewer_assets/__init__.pyruns · 124 bytessrc/mcp_agent_mail/viewer_assets/coi-serviceworker.jsruns · 3,505 bytessrc/mcp_agent_mail/viewer_assets/index.htmlasset · 64,588 bytessrc/mcp_agent_mail/viewer_assets/preview-reload.jsruns · 1,039 bytessrc/mcp_agent_mail/viewer_assets/styles.cssasset · 10,029 bytessrc/mcp_agent_mail/viewer_assets/vendor/clusterize.min.cssasset · 438 bytessrc/mcp_agent_mail/viewer_assets/vendor/clusterize.min.jsruns · 5,405 bytessrc/mcp_agent_mail/viewer_assets/vendor/dompurify.min.jsruns · 21,074 bytessrc/mcp_agent_mail/viewer_assets/vendor/marked.min.jsruns · 34,919 bytessrc/mcp_agent_mail/viewer_assets/vendor/sql-wasm.jsruns · 48,695 bytessrc/mcp_agent_mail/viewer_assets/vendor/sql-wasm.wasmasset · 659,806 bytessrc/mcp_agent_mail/viewer_assets/vendor_manifest.jsonasset · 1,271 bytessrc/mcp_agent_mail/viewer_assets/viewer.jsruns · 70,419 bytestests/__init__.pyruns · 0 bytestests/benchmarks/__init__.pyruns · 42 bytestests/benchmarks/baselines.jsonasset · 2,110 bytestests/benchmarks/bench_fetch_inbox.pyruns · 1,433 bytestests/benchmarks/bench_list_outbox.pyruns · 2,409 bytestests/benchmarks/bench_pathspec.pyruns · 26,324 bytestests/benchmarks/bench_pattern_matching.pyruns · 6,123 bytestests/benchmarks/bench_search.pyruns · 1,581 bytestests/benchmarks/bench_send_message.pyruns · 1,087 bytestests/benchmarks/bench_summarize.pyruns · 2,070 bytestests/benchmarks/conftest.pyruns · 2,045 bytestests/benchmarks/regression.pyruns · 16,068 bytestests/benchmarks/test_ci_regression.pyruns · 10,004 bytestests/benchmarks/utils.pyruns · 9,037 bytestests/conftest.pyruns · 6,606 bytestests/e2e/golden/isomorphism_e2e.jsonasset · 25,912 bytestests/e2e/test_isomorphism_e2e.pyruns · 39,125 bytestests/e2e/test_toon_format_e2e.pyruns · 2,644 bytestests/e2e/test_utils.pyruns · 889 bytestests/e2e/utils.pyruns · 7,082 bytestests/integration/test_archive_workflow.pyruns · 4,167 bytestests/integration/test_mailbox_share_integration.pyruns · 9,726 bytestests/integration/test_worktrees_functionality_e2e.pyruns · 10,216 bytestests/test_ack_views_details.pyruns · 1,267 bytestests/test_agent_activity_touch.pyruns · 8,605 bytestests/test_agent_name_validation.pyruns · 26,446 bytestests/test_am_run_basic.pyruns · 34,906 bytestests/test_app_helpers.pyruns · 6,517 bytestests/test_archive_browser.pyruns · 20,201 bytestests/test_attachment_policy.pyruns · 1,368 bytestests/test_attachments_extended.pyruns · 3,908 bytestests/test_auto_retire_stale_agents.pyruns · 11,988 bytestests/test_broadcast.pyruns · 22,526 bytestests/test_claim_overlap_and_macro_failures.pyruns · 2,693 bytestests/test_cli.pyruns · 37,563 bytestests/test_cli_acks_and_errors.pyruns · 2,093 bytestests/test_cli_additional.pyruns · 2,572 bytestests/test_cli_archive_commands.pyruns · 22,996 bytestests/test_cli_extended.pyruns · 21,163 bytestests/test_cli_guard_commands.pyruns · 25,658 bytestests/test_cli_list_acks_and_main.pyruns · 1,993 bytestests/test_cli_mail_commands.pyruns · 24,590 bytestests/test_cli_stub.pyruns · 4,062 bytestests/test_clone_identity_equivalence.pyruns · 984 bytestests/test_concurrency_agents.pyruns · 43,077 bytestests/test_concurrent_writes.pyruns · 23,724 bytestests/test_contact_and_routing.pyruns · 51,471 bytestests/test_contact_management_flow.pyruns · 51,069 bytestests/test_contact_policy.pyruns · 22,292 bytestests/test_contacts.pyruns · 6,524 bytestests/test_database_failures.pyruns · 19,519 bytestests/test_datetime_regression.pyruns · 16,961 bytestests/test_db_migrations_and_http_main.pyruns · 1,555 bytestests/test_e2e_disaster_recovery.pyruns · 29,925 bytestests/test_e2e_multi_agent_workflow.pyruns · 36,066 bytestests/test_entry_and_llm_errors.pyruns · 588 bytestests/test_entrypoints_and_llm.pyruns · 3,406 bytestests/test_error_invalid_inputs.pyruns · 39,767 bytestests/test_expected_error_filter.pyruns · 14,600 bytestests/test_file_reservation_lifecycle.pyruns · 42,078 bytestests/test_git_archive_failures.pyruns · 20,436 bytestests/test_git_index_lock.pyruns · 10,051 bytestests/test_guard_edges.pyruns · 3,764 bytestests/test_guard_integration.pyruns · 3,350 bytestests/test_guard_prepush.pyruns · 6,608 bytestests/test_guard_rename.pyruns · 3,502 bytestests/test_guard_render.pyruns · 880 bytestests/test_guard_tools.pyruns · 1,784 bytestests/test_guard_worktrees.pyruns · 34,231 bytestests/test_http_auth.pyruns · 29,297 bytestests/test_http_auth_rate_limit.pyruns · 2,747 bytestests/test_http_logging_and_errors.pyruns · 2,775 bytestests/test_http_negative_jwt.pyruns · 4,846 bytestests/test_http_rate_limit.pyruns · 24,263 bytestests/test_http_rate_limiting_comprehensive.pyruns · 21,982 bytestests/test_http_redis_rate_limit.pyruns · 2,004 bytestests/test_http_server.pyruns · 33,350 bytestests/test_http_stateful_mcp_session.pyruns · 5,891 bytestests/test_http_transport.pyruns · 6,975 bytestests/test_http_unit.pyruns · 976 bytestests/test_http_workers_and_options.pyruns · 4,850 bytestests/test_identity.pyruns · 3,147 bytestests/test_identity_ignorecase.pyruns · 1,120 bytestests/test_identity_markers.pyruns · 5,933 bytestests/test_identity_resources.pyruns · 1,975 bytestests/test_identity_worktrees.pyruns · 1,428 bytestests/test_identity_wsl2.pyruns · 1,097 bytestests/test_image_processing_edge.pyruns · 33,000 bytestests/test_llm_and_utils.pyruns · 2,055 bytestests/test_logging_and_redis_fallback.pyruns · 2,042 bytestests/test_macro_start_session_with_claims.pyruns · 5,069 bytestests/test_macros.pyruns · 3,893 bytestests/test_mail_project_threads.pyruns · 33,738 bytestests/test_mail_reply_composer.pyruns · 17,996 bytestests/test_mail_search_templates.pyruns · 10,317 bytestests/test_mail_unified_threads.pyruns · 13,479 bytestests/test_mail_viewer_e2e.pyruns · 28,861 bytestests/test_mailbox_with_commits.pyruns · 995 bytestests/test_main_http_entry.pyruns · 294 bytestests/test_mcp_resources.pyruns · 37,422 bytestests/test_message_delivery_regression.pyruns · 33,292 bytestests/test_messaging_semantics.pyruns · 52,849 bytestests/test_mistake_detection.pyruns · 9,336 bytestests/test_more_resources.pyruns · 1,422 bytestests/test_negative_inputs.pyruns · 3,381 bytestests/test_outbox_and_claims.pyruns · 3,391 bytestests/test_pathspec_overlap.pyruns · 1,182 bytestests/test_performance_benchmarks.pyruns · 41,299 bytestests/test_precommit_bypass.pyruns · 2,054 bytestests/test_precommit_enforcement.pyruns · 22,527 bytestests/test_prepush_enforcement_comprehensive.pyruns · 22,866 bytestests/test_product_bus.pyruns · 3,870 bytestests/test_project_agent_setup.pyruns · 29,702 bytestests/test_query_locality.pyruns · 21,877 bytestests/test_remote_normalization.pyruns · 2,345 bytestests/test_reply_and_threads.pyruns · 5,003 bytestests/test_repo_cache.pyruns · 10,839 bytestests/test_resource_cleanup.pyruns · 13,703 bytestests/test_resource_edges.pyruns · 2,205 bytestests/test_resources_mailbox.pyruns · 4,915 bytestests/test_security_input_sanitization.pyruns · 31,429 bytestests/test_security_path_traversal.pyruns · 21,308 bytestests/test_server.pyruns · 58,061 bytestests/test_server_lock.pyruns · 6,882 bytestests/test_session_context_regression.pyruns · 25,706 bytestests/test_share_export.pyruns · 75,949 bytestests/test_startup_banner_db_reset.pyruns · 6,083 bytestests/test_storage_edges.pyruns · 50,717 bytestests/test_storage_inline_fallback.pyruns · 1,256 bytestests/test_summarize_recent.pyruns · 13,599 bytestests/test_summarize_threads_extended.pyruns · 1,799 bytestests/test_summarize_threads_llm_off.pyruns · 1,859 bytestests/test_summarize_threads_llm_on.pyruns · 2,333 bytestests/test_time_travel.pyruns · 25,517 bytestests/test_tool_descriptions.pyruns · 853 bytestests/test_tool_filter_and_notifications.pyruns · 12,673 bytestests/test_tooling_and_views_resources.pyruns · 2,273 bytestests/test_tooling_resources.pyruns · 4,637 bytestests/test_toon_encoder_identification.pyruns · 5,909 bytestests/test_toon_formatting.pyruns · 3,777 bytestests/test_unread_only_filter.pyruns · 10,226 bytestests/test_utils_config_db_edges.pyruns · 7,426 bytestests/test_viewer_storage.pyruns · 29,001 bytestests/test_virtual_reservations.pyruns · 10,451 bytestests/test_web_ui_icon_rendering.pyruns · 5,975 bytestests/test_window_identity.pyruns · 17,164 bytestests/test_worktree_conflict_integration.pyruns · 2,394 bytestests/test_xss_corpus.pyruns · 22,935 bytesthird_party_docs/PYTHON_FASTMCP_BEST_PRACTICES.mddoc · 32,897 bytesthird_party_docs/fastmcp_distilled_docs.mddoc · 123,038 bytesthird_party_docs/mcp_protocol_specs.mddoc · 308,577 bytesthird_party_docs/sqlite_json_distilled_docs.mddoc · 59,042 bytesuv.lockasset · 636,744 bytesweb/index.htmlasset · 1,443 byteswindsurf.mcp.jsonasset · 262 bytes
No licensed excerpt is available. You can inspect the pinned source.