Heartbeat MCP server

Connect Heartbeat to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Heartbeat MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create comment tool in Heartbeat
  • Use the create event tool in Heartbeat
  • Use the create channel tool in Heartbeat
  • Use the manage group tool in Heartbeat
  • Use the send invitation tool in Heartbeat
  • Use the deactivate member tool in Heartbeat

Supported Tools

create_comment

Create Comment

Creates a comment on an existing thread. Content can be plain text or rich text (HTML). When rich text is provided, plain text is ignored.

create_event

Create Event

DEPRECATED — use `schedule_event` instead. Creates a new event in your Heartbeat community. Events can have a location (Zoom requires an integrated Zoom account, Heartbeat creates a custom voice channel). You can invite attendees by email — existing users are invited directly, others receive an email invite.

create_channel

Create Channel

DEPRECATED — use `create_community_channel` instead. Creates a new channel in your Heartbeat community. Channels can be of type thread, chat, or voice.

manage_group

Manage Group

Creates a new group or manages group membership in your Heartbeat community. Can create groups, add users to groups, or remove users from groups. When adding a user, you can optionally remove them from sibling groups (groups sharing a parent), useful for moving users between stages.

send_invitation

Send Invitation

Sends an invitation email to a new user to join your Heartbeat community. Optionally specify a pre-approved invitation link to automatically approve the user.

deactivate_member

Deactivate Member

Deactivates a user in your Heartbeat community. The user will no longer be able to access the community, but their threads, comments, and messages are preserved. Can also reactivate a previously deactivated user.

create_thread

Create Thread

Creates a new thread in a specific channel. Content can be plain text or rich text (HTML). When rich text is provided, plain text is ignored. Supported HTML tags: p, a, b, h1, h2, h3, ul, li, br.

update_member

Update Member

DEPRECATED — use `edit_member_profile` instead. Updates an existing user's information in your Heartbeat community. Can update name, email, roles, groups, bio, social links, and other profile fields.

send_direct_message

Send Direct Message

Sends a direct message to a community member. Useful for automated notifications, bot responses, or personalized outreach.

find_user

Find User

Finds a user in your Heartbeat community by email address or retrieves a specific user by ID.

create_member

Create Member

DEPRECATED — use `provision_member` instead. Creates a new user in your Heartbeat community. Optionally assign groups, set a profile picture, bio, social links, and trigger an introduction thread.

get_recent_posts

Get Recent Posts

DEPRECATED — use `list_channel_threads` instead. Retrieves the most recently created threads in your Heartbeat community. Can filter by channel. "Recent" refers to creation timestamp — only the most recently created posts are returned.

list_members

List Members

Lists members of your Heartbeat community with optional filtering by group, role, or creation date. Returns a paginated list of users.

list_channels

List Channels

Lists channels in your Heartbeat community with optional filtering by type or archived status.

list_groups

List Groups

Lists access groups in your Heartbeat community with optional filtering. Can filter by parent group or by user membership.

list_events

List Events

List community events, optionally filtered by an access group from list_access_groups. Returns provider event IDs, times, invited members and groups, and metadata.

create_community_channel

Create Community Channel

Create a thread, chat, or voice channel using a category ID from list_channel_categories. Returns the actual HTTP status and provider response.

list_channel_categories

List Channel Categories

Discover the channel category IDs and names needed to create community channels.

get_thread

Get Thread

Read one thread, including its comments, reactions, provider permalink, and file URL metadata.

list_channel_threads

List Channel Threads

Read threads from one channel, newest by creation time first. Discover channel IDs with list_community_channels. Responses retain provider permalinks, file URLs, comments, and other metadata.

list_roles

List Roles

Discover the community role IDs and names needed to provision members or create invitation links.

get_event

Get Event

Retrieve one community event by an ID from list_events, preserving provider metadata.

list_community_channels

List Community Channels

List all community channels with provider channel types and draft state. This endpoint is not paginated.

schedule_event

Schedule Event

Create an event with the start time, duration, location, and optional invited emails or group IDs. Returns the actual HTTP status and provider response.

edit_member_profile

Edit Member Profile

Update a member profile using their existing email address. This operation does not change the member email, role, or groups. Use manage_group_memberships for group membership changes.

manage_group_memberships

Manage Group Memberships

Add members to, or remove members from, an access group using email addresses. Discover the group ID with list_access_groups. Adding members can remove them from sibling groups.

list_invitations

List Invitation Links

List community invitation links with their actual codes, roles, and groups. Invitation codes do not identify an API key or the current user.

provision_member

Provision Member

Create a community member with a full name and a role. Discover role IDs with list_roles and group IDs with list_access_groups. Returns the actual HTTP status and provider response without assuming a profile was returned.

post_thread

Post Thread

Create a thread using formatted text in a channel from list_community_channels. Returns the actual thread with its provider permalink, file URLs, and metadata.

change_member_access

Change Member Access

Deactivate or reactivate a member by email. Deactivation removes community access while preserving threads, comments, and messages.

list_community_members

List Community Members

List all members returned by the Heartbeat community API, including role names and group memberships. This endpoint is not paginated.

find_members

Find Members

Find community members by email, or retrieve one member by user ID. Returns the complete documented profile and additional provider metadata.

create_access_group

Create Access Group

Create an access group, optionally assigning member emails and a parent group. Discover existing group IDs with list_access_groups. Returns the actual HTTP status and provider response.

list_access_groups

List Access Groups

List all community access groups, their parent IDs, archived state, and member information. This endpoint is not paginated.

post_comment

Post Comment

Create a thread comment or a reply to a top-level comment using formatted text. Heartbeat supports two comment levels. Returns the actual comment and provider metadata.

Connect Heartbeat to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Heartbeat in Metorial. In your Metorial portal, enable the Heartbeat MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Heartbeat tools.

Run Heartbeat through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Heartbeat and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Heartbeat tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Heartbeat

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Technical notes for Heartbeat

Manage an online community on Heartbeat. Create, retrieve, update, and deactivate members. Manage groups and group membership, including moving users between groups. Create threads and comments in channels with plain text or rich text (HTML) content. Create channels and events, with support for Zoom or built-in voice locations. Send direct messages to community members. Send invitation emails to new users. Configure webhooks to receive notifications for community activity such as new users, threads, events, group joins, course completions, event RSVPs, direct messages, and abandoned invitations.

Frequently asked questions

Common questions about connecting Heartbeat to AI agents with Metorial.

  1. How many tools does the Heartbeat MCP server have?
    The Heartbeat MCP server exposes 36 tools, including Create Comment, Create Event, Create Channel. Each one is governed and traced through Metorial.
  2. Heartbeat exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Heartbeat MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Heartbeat and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Heartbeat MCP server yourself or use the hosted gateway.

Connect Heartbeat to production AI agents

See how Metorial gives your team governed access to Heartbeat, with tracing and security controls built in.