addai-chat-mcp

MCP server for +Ai Chat. Lets Claude (and any other MCP client) read your chat conversations and send messages on your behalf, scoped to an API key you generate from Settings.

Install

The fastest path is the interactive setup:

npx addai-chat-mcp --setup

It asks for your API key, then writes the right config into Claude Desktop (Windows & macOS) and Claude Code's global ~/.claude.json for you. Restart Claude after running it.

Get an API key

1. Open +Ai Chat → Settings → Integrations.
2. Click New Key, name it (e.g. "Claude on my laptop"), and create.
3. Copy the aic_user_… key shown once. You won't see it again — save it somewhere safe.

Manual install

If you prefer to wire it yourself, add this to your MCP config:

{
  "mcpServers": {
    "addai-chat": {
      "command": "npx",
      "args": ["-y", "addai-chat-mcp"],
      "env": {
        "ADDAI_CHAT_API_KEY": "aic_user_…"
      }
    }
  }
}

Tools

Discovery

• me — show the current key, its permissions, and accessible workspaces.
• list_workspaces — list workspaces this key can see.
• list_workspace_members — list people in a workspace.
• get_profile — fetch a single profile by id.

Conversations

• list_conversations — DMs and groups in a workspace.
• get_conversation — details + participants for one conversation.
• create_dm — start a 1:1 chat with another user.
• create_group — create a group chat with named members.
• update_conversation — rename or update a group's description.
• add_members / remove_member — manage group membership.
• leave_conversation — leave a group.
• mark_read — mark a conversation read up to now.
• pin_conversation — pin or unpin a conversation.

Messages

• list_messages — paginate a conversation's history (newest first).
• send_message — post a message. Supports reply_to_id and attachments.
• edit_message / delete_message — only on your own messages.
• toggle_reaction — add or remove an emoji reaction.

Search

• search_messages — full-text across a workspace, optionally scoped to one conversation.

Attachments

• upload_attachment — upload a local file and get an attachment object you can pass into send_message.
• get_attachment — look up an attachment by id.

Permissions

Each key has a chat permission namespace with toggleable resources:

| Resource | Actions | |---|---| | conversations | read, create, update, delete | | messages | read, create, update, delete | | members | read, manage | | attachments | read, upload |

By default every action is on; tighten in the Create-Key modal if you want a read-only or restricted key.

Keys are user-level: they automatically pick up every workspace you're a member of, and lose access when you leave a workspace.

Rate limits

Default 60 requests/minute, 10,000/day. The MCP raises an error if you hit them — wait and retry.

Troubleshooting

| Symptom | Cause | |---|---| | ADDAI_CHAT_API_KEY environment variable is required | Env var not set in your MCP config. | | [UNAUTHORIZED] Invalid or missing API key | Key revoked or typed wrong. Mint a fresh one. | | [FORBIDDEN] Missing chat.<resource>.<action> permission | That action is turned off on the key. Either flip it on (revoke + recreate) or use a different key. | | [WORKSPACE_ACCESS_REVOKED] | You're no longer a member of that workspace. | | [RATE_LIMITED] | Slow down or wait until the limit resets. |

License

MIT.