Skip to content
BranchesTags

Repository files navigation

BuddyPress MCP Server

A Model Context Protocol (MCP) server that provides comprehensive integration with BuddyPress REST API v2. This server enables AI assistants like Claude to interact with BuddyPress sites, managing activities, members, groups, profiles, messages, and more.

Features

Activity Management

  • List, create, update, and delete activity items
  • Favorite/unfavorite activities
  • Filter by user, group, scope, and search terms

Member Management

  • List and search members
  • Get member profiles
  • Update member information
  • Delete members

Group Management

  • List, create, update, and delete groups
  • Manage group membership
  • Handle group invites and membership requests
  • Filter groups by status, type, and user

XProfile (Extended Profiles)

  • List profile field groups and fields
  • Get and update user profile data
  • Manage custom profile fields

Friends & Social

  • List friendships
  • Create and manage friend requests
  • Delete friendships

Messages

  • List message threads
  • Send new messages
  • Manage conversations
  • Filter by inbox/sentbox

Notifications

  • List user notifications
  • Mark notifications as read/unread
  • Delete notifications

Components

  • List active BuddyPress components

Installation

  1. Clone or create the directory:

    mkdir buddypress-mcp
cd buddypress-mcp

  2. Install dependencies:

    npm install

  3. Build the TypeScript code:

    npm run build

Configuration

Set the following environment variables:

export BUDDYPRESS_URL="http://yourdomain.com"
export BUDDYPRESS_USERNAME="your-username"
export BUDDYPRESS_PASSWORD="your-application-password"

Creating an Application Password

For WordPress/BuddyPress authentication:

  1. Go to your WordPress admin dashboard
  2. Navigate to Users → Profile
  3. Scroll to "Application Passwords" section
  4. Create a new application password
  5. Use this password (not your regular password) for authentication

Usage with Claude Desktop

Add this configuration to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "buddypress": {
      "command": "node",
      "args": [
        "/path/to/buddypress-mcp/dist/index.js"
      ],
      "env": {
        "BUDDYPRESS_URL": "http://buddypress.local",
        "BUDDYPRESS_USERNAME": "admin",
        "BUDDYPRESS_PASSWORD": "your-application-password"
      }
    }
  }
}

After adding the configuration, restart Claude Desktop.

Available Tools

Activity Tools

  • buddypress_list_activities - List activity stream items
  • buddypress_get_activity - Get single activity
  • buddypress_create_activity - Create new activity
  • buddypress_update_activity - Update activity
  • buddypress_delete_activity - Delete activity
  • buddypress_favorite_activity - Favorite/unfavorite activity

Member Tools

  • buddypress_list_members - List members
  • buddypress_get_member - Get single member
  • buddypress_update_member - Update member profile
  • buddypress_delete_member - Delete member

Group Tools

  • buddypress_list_groups - List groups
  • buddypress_get_group - Get single group
  • buddypress_create_group - Create new group
  • buddypress_update_group - Update group
  • buddypress_delete_group - Delete group
  • buddypress_list_group_members - List group members
  • buddypress_add_group_member - Add member to group
  • buddypress_remove_group_member - Remove member from group

XProfile Tools

  • buddypress_list_xprofile_groups - List field groups
  • buddypress_get_xprofile_group - Get field group
  • buddypress_list_xprofile_fields - List profile fields
  • buddypress_get_xprofile_field - Get profile field
  • buddypress_get_xprofile_data - Get user profile data
  • buddypress_update_xprofile_data - Update user profile data

Friends Tools

  • buddypress_list_friends - List friendships
  • buddypress_create_friendship - Create friend request
  • buddypress_delete_friendship - Delete friendship

Messages Tools

  • buddypress_list_messages - List message threads
  • buddypress_get_message - Get message thread
  • buddypress_create_message - Send new message
  • buddypress_delete_message - Delete message thread

Notifications Tools

  • buddypress_list_notifications - List notifications
  • buddypress_get_notification - Get single notification
  • buddypress_update_notification - Update notification status
  • buddypress_delete_notification - Delete notification

Components Tool

  • buddypress_list_components - List active components

WordPress Abilities API Tools

  • wordpress_list_abilities - List registered 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

WordPress Abilities API

The server includes tools for the WordPress Abilities API (WP 6.9+). These tools are future-proof — any plugin that registers abilities will be automatically discoverable and executable through this MCP server.

BuddyPress Abilities mu-plugin

A companion mu-plugin is included in extras/mu-plugins/buddypress-abilities.php that registers 8 BuddyPress-specific abilities:

Ability Type Description
buddypress/community-stats Read Member/group/activity counts and active components
buddypress/recent-activity Read Recent activity stream items
buddypress/member-search Read Search members by name
buddypress/group-search Read Search groups by name/description
buddypress/profile-completeness Read Profile completion percentage and empty fields
buddypress/create-activity Action Post a new activity update
buddypress/send-message Action Send a private message
buddypress/send-friendship-request Action Send a friendship request

To install: Copy the file to your WordPress site's wp-content/mu-plugins/ directory:

cp extras/mu-plugins/buddypress-abilities.php /path/to/wordpress/wp-content/mu-plugins/

Requires WordPress 6.9+ and BuddyPress. No configuration needed — abilities register automatically.

Example Usage

Once configured, you can ask Claude to interact with your BuddyPress site:

"Show me the latest 10 activities on my BuddyPress site"

"Create a new activity post with the content 'Hello from MCP!'"

"List all groups and show me their member counts"

"Get the profile data for user ID 5"

"Send a message to users 3 and 4 with subject 'Meeting' and content 'Let's meet tomorrow'"

"Show me all unread notifications for user 2"

"List all available WordPress abilities"

"Execute the buddypress/community-stats ability"

"Search for members named John using the abilities API"

Development

Build

npm run build

Watch Mode

npm run watch

Run

npm start

Security Notes

  1. Application Passwords: Always use WordPress Application Passwords instead of your main password
  2. HTTPS: Use HTTPS in production environments
  3. Permissions: Ensure the authenticated user has appropriate permissions
  4. Environment Variables: Never commit credentials to version control

API Reference

This MCP server uses BuddyPress REST API v2. For detailed API documentation, visit:

Troubleshooting

Authentication Errors

  • Verify your application password is correct
  • Check that the user has necessary permissions
  • Ensure the BuddyPress REST API is accessible

Connection Errors

  • Verify the BUDDYPRESS_URL is correct
  • Check that the site is accessible
  • Ensure no firewall or security plugins are blocking API requests

Tool Not Found

  • Restart Claude Desktop after configuration changes
  • Check the config file syntax is valid JSON
  • Verify the path to the built JavaScript file is correct

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

MIT License

Support

For issues and questions:

Version History

2.1.0

  • WordPress Abilities API integration (5 new tools)
  • BuddyPress abilities mu-plugin (8 abilities)
  • wordpress://abilities/registry resource
  • wordpressRequest() / wordpressPaginatedRequest() client functions

2.0.0

  • Modular architecture refactor
  • 42 new tools, resources, and prompts

1.0.0

  • Initial release
  • Support for Activity, Members, Groups, XProfile, Friends, Messages, Notifications
  • Full CRUD operations for major endpoints
  • Comprehensive filtering and pagination

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

2 stars

Watchers

0 watching

Forks

2 forks
Report repository

Releases

Packages

Contributors

Languages