BuddyPress

You can run a dedicated MCP server that bridges BuddyPress REST API v2 with your AI assistants, enabling automated management of activities, members, groups, profiles, messages, and more. This server exposes a rich set of actions you can call from your MCP client to interact with BuddyPress sites in a structured, programmable way.

How to use

After you have the server running, you will connect your MCP client to the local process and issue high-level tool calls that map to BuddyPress endpoints. You can list, create, update, and delete activities; manage members and groups; work with extended profiles; handle friendships, messages, and notifications; and query active components. Use the available tools to craft workflows such as creating a post, inviting a member to a group, sending a message, or retrieving a user’s profile data. Ensure authentication is configured using the provided environment variables and that your target BuddyPress site is reachable.

How to install

Prerequisites: You need Node.js and npm installed on your system. You will also need access to a WordPress/BuddyPress site for authentication via application passwords.

Step by step install and run sequence follows a local MCP server pattern. Create the project folder, install dependencies, build the TypeScript code, and start the server as shown.

Configuration

Set the following environment variables to point the MCP server at your BuddyPress site and provide credentials.

Security notes

Always use WordPress Application Passwords instead of your main password. Enforce HTTPS in production. Ensure the authenticated user has appropriate permissions and never commit credentials to version control.

Example usage with Claude Desktop

Provide a Claude Desktop configuration that runs the local MCP server and supplies connection details via environment variables.

Development

You can build, watch, and run the server during development to iterate on improvements.

Troubleshooting

Refer to common issues around authentication, connectivity, and configuration syntax. Verify the BuddyPress URL, ensure the site is accessible, and confirm that the application password and user permissions are correct.

Available tools

buddypress_list_activities

List activity stream items

buddypress_get_activity

Get a single activity by ID

buddypress_create_activity

Create a new activity update

buddypress_update_activity

Update an existing activity

buddypress_delete_activity

Delete an activity

buddypress_favorite_activity

Mark an activity as favorite or unfavorite

buddypress_list_members

List members

buddypress_get_member

Get a member profile by ID

buddypress_update_member

Update member profile information

buddypress_delete_member

Delete a member

buddypress_list_groups

List groups

buddypress_get_group

Get a single group by ID

buddypress_create_group

Create a new group

buddypress_update_group

Update group details

buddypress_delete_group

Delete a group

buddypress_list_group_members

List members of a group

buddypress_add_group_member

Add a member to a group

buddypress_remove_group_member

Remove a member from a group

buddypress_list_xprofile_groups

List field groups for XProfile

buddypress_get_xprofile_group

Get a field group by ID

buddypress_list_xprofile_fields

List profile fields

buddypress_get_xprofile_field

Get a profile field by ID

buddypress_get_xprofile_data

Get user profile data

buddypress_update_xprofile_data

Update user profile data

buddypress_list_friends

List friendships

buddypress_create_friendship

Create a friend request

buddypress_delete_friendship

Delete a friendship

buddypress_list_messages

List message threads

buddypress_get_message

Get a message thread

buddypress_create_message

Send a new private message

buddypress_delete_message

Delete a message thread

buddypress_list_notifications

List notifications

buddypress_get_notification

Get a single notification

buddypress_update_notification

Update notification status

buddypress_delete_notification

Delete a notification

buddypress_list_components

List active BuddyPress components

wordpress_list_abilities

List WordPress abilities (filterable by category)

wordpress_get_ability

Get full details of an ability including input/output schemas

wordpress_execute_ability

Execute any ability (GET for read-only, POST for actions)

wordpress_list_ability_categories

List ability categories

wordpress_get_ability_category

Get category details