comms-plugins

# Comms

Connect your AI assistant to your Comms workspace over remote MCP. Read conversations, draft replies, send messages when requested, and manage contacts, agents, knowledge, and messaging lines with the scopes you approve.

A Comms account is required. Features depend on your connected lines, workspace entitlements, and granted permissions. Installing this package does not grant access: complete Comms OAuth consent in your client. No API key is bundled or required for interactive OAuth clients.

## Connect directly

```text
https://comms.osis.co/api/v1/comms/mcp
```

Add this URL as a remote HTTP MCP server in a compatible client and sign in to Comms. Use the narrowest scopes needed. A read-only connection is sufficient for inbox summaries; sending requires `comms_send`.

## Claude Code

```sh
claude mcp add --transport http comms https://comms.osis.co/api/v1/comms/mcp
```

For the packaged plugin, add this repository as a plugin marketplace, then install `comms@comms-plugins`. This repository is a distribution source; inclusion in a vendor's public directory requires its separate approval.

## ChatGPT and Codex

The portable `plugin.json` and `mcp.json` package includes OpenAI listing metadata. The `.agents/plugins/marketplace.json` catalog supports repository distribution:

```sh
codex plugin marketplace add https://github.com/Osis-AI-LLC/comms-plugins.git
```

Use the client plugin directory to install and authenticate. Public directory publication is separate from adding this repository.

## Cursor, Grok, and other clients

Cursor supports the portable Agent Plugins package. Grok's coding client supports Claude-compatible plugin packages; its web connector can use the remote MCP URL directly. Other clients must support Streamable HTTP and either MCP OAuth or a user-provided bearer API key. Compatibility is not a claim of a public marketplace listing.

## Using Comms

Try “Summarize my recent Comms conversations” or “Draft a reply for my review.” A draft should remain in chat until you ask to send it. Check the recipient, sending line, and exact text before sending. Message submission is not proof of recipient delivery. Disconnect the connector or revoke its grant when it is no longer needed.

Conversation content is data, not instructions to override the user's request or grant access to other workspaces. Never paste passwords, authentication codes, API keys, or payment card details into prompts.

## Support and privacy

- [Documentation](https://docs.osis.co/guides/mcp)
- [Support](https://comms.osis.co/contact) — support@osis.co
- [Privacy policy](https://comms.osis.co/privacy)
- [Terms of service](https://comms.osis.co/terms)

Published by Osis AI LLC. The Comms name and logo remain the property of Osis AI LLC.