habitica-social - Pinkfish - AI Agents & Workflows for Getting Work Done

Server path: /habitica-social | Type: Application | PCID required: Yes

Tools

Tool	Description
`habitica_social_create_challenges`	Create a challenge
`habitica_social_create_challenges_by_challenge_id_clone`	Clone a challenge
`habitica_social_create_challenges_by_challenge_id_join`	Join a challenge
`habitica_social_create_challenges_by_challenge_id_leave`	Leave Challenge
`habitica_social_create_challenges_by_challenge_id_select_winner_by_winner_id`	Select Challenge Winner
`habitica_social_create_groups`	Create a Group
`habitica_social_create_groups_by_group_id_add_manager`	Add Group Manager
`habitica_social_create_groups_by_group_id_chat`	Send a chat message in a group
`habitica_social_create_groups_by_group_id_chat_by_chat_id_clearflags`	Clear flags
`habitica_social_create_groups_by_group_id_chat_by_chat_id_flag`	Flag a group chat message
`habitica_social_create_groups_by_group_id_chat_by_chat_id_like`	Like Group Chat Message
`habitica_social_create_groups_by_group_id_chat_seen`	Mark Group Chat Messages as Seen
`habitica_social_create_groups_by_group_id_invite`	Invite users to a group
`habitica_social_create_groups_by_group_id_join`	Join a group
`habitica_social_create_groups_by_group_id_leave`	Leave a group
`habitica_social_create_groups_by_group_id_quests_abort`	Abort Group Quest
`habitica_social_create_groups_by_group_id_quests_accept`	Accept Group Quest
`habitica_social_create_groups_by_group_id_quests_cancel`	Cancel Group Quest
`habitica_social_create_groups_by_group_id_quests_force_start`	Force-Start Group Quest
`habitica_social_create_groups_by_group_id_quests_invite_by_quest_key`	Invite users to a quest
`habitica_social_create_groups_by_group_id_quests_leave`	Leave Group Quest
`habitica_social_create_groups_by_group_id_quests_reject`	Reject Group Quest
`habitica_social_create_groups_by_group_id_reject_invite`	Reject a group invitation
`habitica_social_create_groups_by_group_id_remove_manager`	Remove a manager from a group
`habitica_social_create_groups_by_group_id_remove_member_by_member_id`	Remove a member from a group
`habitica_social_create_groups_create_plan`	Create Group Plan
`habitica_social_create_groups_party_chat`	Send a chat message to the party
`habitica_social_create_members_send_private_message`	Send Private Message
`habitica_social_create_members_transfer_gems`	Transfer Gems
`habitica_social_delete_challenges_by_challenge_id`	Delete a challenge
`habitica_social_delete_groups_by_group_id_chat_by_chat_id`	Delete chat message from a group
`habitica_social_get_challenges_by_challenge_id`	Get challenges for a group
`habitica_social_get_challenges_by_challenge_id_export_csv`	Export Challenge to CSV
`habitica_social_get_challenges_by_challenge_id_members`	Get members for a challenge
`habitica_social_get_challenges_by_challenge_id_members_by_member_id`	Get a challenge member progress
`habitica_social_get_challenges_groups_by_group_id`	Get challenges for a group
`habitica_social_get_challenges_user`	Get challenges for a user
`habitica_social_get_group_plans`	Get Group Plans
`habitica_social_get_groups`	Get user’s groups
`habitica_social_get_groups_by_group_id`	Get group information
`habitica_social_get_groups_by_group_id_chat`	Get group chat messages
`habitica_social_get_groups_by_group_id_invites`	Get invites for a group
`habitica_social_get_groups_by_group_id_members`	Get members for a group
`habitica_social_get_groups_party_chat`	Get party chat messages
`habitica_social_get_looking_for_party`	Get users in search of parties
`habitica_social_get_members_by_member_id`	Get habitica member by ID
`habitica_social_get_members_by_member_id_achievements`	Get member achievements object
`habitica_social_get_members_by_to_user_id_objections_by_interaction`	Get objections to interaction
`habitica_social_update_challenges_by_challenge_id`	Update a challenge
`habitica_social_update_groups_by_group_id`	Update Group

habitica_social_create_challenges

Create a challenge Parameters:

Parameter	Type	Required	Default	Description
`description`	string	No	—	A detailed description of the challenge.
`group`	string	Yes	—	The UUID of the group to which the challenge belongs.
`name`	string	Yes	—	The full name of the challenge.
`official`	boolean	No	—	Specifies whether the challenge is an official Habitica challenge.
`prize`	number	No	—	The prize or reward associated with the challenge.
`shortName`	string	Yes	—	A shortened name for the challenge, to be used as a tag.
`summary`	string	No	—	A short summary advertising the main purpose of the challenge; maximum 250 characters; if not supplied, challenge.name will be used.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "description": {
      "type": "string",
      "description": "A detailed description of the challenge."
    },
    "group": {
      "type": "string",
      "description": "The UUID of the group to which the challenge belongs."
    },
    "name": {
      "type": "string",
      "description": "The full name of the challenge."
    },
    "official": {
      "type": "boolean",
      "description": "Specifies whether the challenge is an official Habitica challenge."
    },
    "prize": {
      "type": "number",
      "description": "The prize or reward associated with the challenge."
    },
    "shortName": {
      "type": "string",
      "description": "A shortened name for the challenge, to be used as a tag."
    },
    "summary": {
      "type": "string",
      "description": "A short summary advertising the main purpose of the challenge; maximum 250 characters; if not supplied, challenge.name will be used."
    }
  },
  "required": [
    "PCID",
    "group",
    "name",
    "shortName"
  ]
}

habitica_social_create_challenges_by_challenge_id_clone

Clone a challenge Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	ID of the challenge to clone

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "ID of the challenge to clone"
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_create_challenges_by_challenge_id_join

Join a challenge Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	ID of the challenge

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "ID of the challenge"
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_create_challenges_by_challenge_id_leave

Leave Challenge Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	ID of the challenge to leave
`keep`	string	No	—	Specify whether to remove all or keep all challenge-related tasks upon leaving.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "ID of the challenge to leave"
    },
    "keep": {
      "type": "string",
      "description": "Specify whether to remove all or keep all challenge-related tasks upon leaving.",
      "enum": [
        "remove-all",
        "keep-all"
      ]
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_create_challenges_by_challenge_id_select_winner_by_winner_id

Select Challenge Winner Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	The Challenge ID for the challenge to close with a winner.
`winnerId`	string	Yes	—	The User ID of the winning user.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "The Challenge ID for the challenge to close with a winner."
    },
    "winnerId": {
      "type": "string",
      "description": "The User ID of the winning user."
    }
  },
  "required": [
    "PCID",
    "challengeId",
    "winnerId"
  ]
}

habitica_social_create_groups

Create a Group Parameters:

Parameter	Type	Required	Default	Description
`name`	string	Yes	—	The name of the new group.
`privacy`	string	Yes	—	Privacy of group (party MUST be private)
`type`	string	Yes	—	Type of group (guild or party)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "name": {
      "type": "string",
      "description": "The name of the new group."
    },
    "privacy": {
      "type": "string",
      "description": "Privacy of group (party MUST be private)",
      "enum": [
        "private",
        "public"
      ]
    },
    "type": {
      "type": "string",
      "description": "Type of group (guild or party)",
      "enum": [
        "guild",
        "party"
      ]
    }
  },
  "required": [
    "PCID",
    "name",
    "privacy",
    "type"
  ]
}

habitica_social_create_groups_by_group_id_add_manager

Add Group Manager Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`managerId`	string	Yes	—	The UUID of the user.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "managerId": {
      "type": "string",
      "description": "The UUID of the user."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "managerId"
  ]
}

habitica_social_create_groups_by_group_id_chat

Send a chat message in a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`previousMsg`	string	No	—	The previous chat message’s UUID which will force a return of the full group chat.
`message`	string	No	—	The content of the chat message.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "previousMsg": {
      "type": "string",
      "description": "The previous chat message's UUID which will force a return of the full group chat."
    },
    "message": {
      "type": "string",
      "description": "The content of the chat message."
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_chat_by_chat_id_clearflags

Clear flags Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`chatId`	string	Yes	—	The UUID of the chat message to clear flags from.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "chatId": {
      "type": "string",
      "description": "The UUID of the chat message to clear flags from."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "chatId"
  ]
}

habitica_social_create_groups_by_group_id_chat_by_chat_id_flag

Flag a group chat message Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted).
`chatId`	string	Yes	—	The chat message id.
`comment`	string	No	—	Explanation why the message was flagged.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)."
    },
    "chatId": {
      "type": "string",
      "description": "The chat message id."
    },
    "comment": {
      "type": "string",
      "description": "Explanation why the message was flagged."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "chatId"
  ]
}

habitica_social_create_groups_by_group_id_chat_by_chat_id_like

Like Group Chat Message Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`chatId`	string	Yes	—	The UUID of the chat message to like.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "chatId": {
      "type": "string",
      "description": "The UUID of the chat message to like."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "chatId"
  ]
}

habitica_social_create_groups_by_group_id_chat_seen

Mark Group Chat Messages as Seen Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_invite

Invite users to a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`emails`	object[]	No	—	An array of objects, each representing one email address to invite.
`uuids`	string[]	No	—	An array of user IDs to invite.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "emails": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "An array of objects, each representing one email address to invite."
    },
    "uuids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "description": "An array of user IDs to invite."
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_join

Join a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_leave

Leave a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`keep`	string	No	—	Specify whether to remove or keep challenges when leaving the group.
`keepChallenges`	string	No	—	Specify whether to remain in challenges or leave challenges upon leaving the group.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "keep": {
      "type": "string",
      "description": "Specify whether to remove or keep challenges when leaving the group.",
      "enum": [
        "remove-all",
        "keep-all"
      ]
    },
    "keepChallenges": {
      "type": "string",
      "description": "Specify whether to remain in challenges or leave challenges upon leaving the group.",
      "enum": [
        "remain-in-challenges",
        "leave-challenges"
      ]
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_quests_abort

Abort Group Quest Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (or ‘party’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id (or 'party')"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_quests_accept

Accept Group Quest Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (or ‘party’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id (or 'party')"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_quests_cancel

Cancel Group Quest Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (or ‘party’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id (or 'party')"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_quests_force_start

Force-Start Group Quest Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (or ‘party’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id (or 'party')"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_quests_invite_by_quest_key

Invite users to a quest Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (or ‘party’)
`questKey`	string	Yes	—	The unique key of the quest.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id (or 'party')"
    },
    "questKey": {
      "type": "string",
      "description": "The unique key of the quest."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "questKey"
  ]
}

habitica_social_create_groups_by_group_id_quests_leave

Leave Group Quest Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (or ‘party’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id (or 'party')"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_quests_reject

Reject Group Quest Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (or ‘party’)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id (or 'party')"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_reject_invite

Reject a group invitation Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_create_groups_by_group_id_remove_manager

Remove a manager from a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`managerId`	string	Yes	—	The UUID of the user.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "managerId": {
      "type": "string",
      "description": "The UUID of the user."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "managerId"
  ]
}

habitica_social_create_groups_by_group_id_remove_member_by_member_id

Remove a member from a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`memberId`	string	Yes	—	The ID of the member to be removed from the group.
`message`	string	No	—	The message to send to the removed members.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "memberId": {
      "type": "string",
      "description": "The ID of the member to be removed from the group."
    },
    "message": {
      "type": "string",
      "description": "The message to send to the removed members."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "memberId"
  ]
}

habitica_social_create_groups_create_plan

Create Group Plan Parameters:

Parameter	Type	Required	Default	Description
`description`	string	No	—	The description of the group plan.
`gems`	integer	No	—	The number of gems required for the plan.
`interval`	string	No	—	The interval of the plan in cron syntax.
`name`	string	No	—	The name of the group plan.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "description": {
      "type": "string",
      "description": "The description of the group plan."
    },
    "gems": {
      "type": "integer",
      "description": "The number of gems required for the plan."
    },
    "interval": {
      "type": "string",
      "description": "The interval of the plan in cron syntax."
    },
    "name": {
      "type": "string",
      "description": "The name of the group plan."
    }
  },
  "required": [
    "PCID"
  ]
}

habitica_social_create_groups_party_chat

Send a chat message to the party Parameters:

Parameter	Type	Required	Default	Description
`previousMsg`	string	No	—	The previous chat message’s UUID which will force a return of the full group chat.
`message`	string	No	—	The content of the chat message.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "previousMsg": {
      "type": "string",
      "description": "The previous chat message's UUID which will force a return of the full group chat."
    },
    "message": {
      "type": "string",
      "description": "The content of the chat message."
    }
  },
  "required": [
    "PCID"
  ]
}

habitica_social_create_members_send_private_message

Send Private Message Parameters:

Parameter	Type	Required	Default	Description
`message`	string	Yes	—	The private message to be sent.
`toUserId`	string	Yes	—	The UUID of the user to whom the message will be sent.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "message": {
      "type": "string",
      "description": "The private message to be sent."
    },
    "toUserId": {
      "type": "string",
      "description": "The UUID of the user to whom the message will be sent."
    }
  },
  "required": [
    "PCID",
    "message",
    "toUserId"
  ]
}

habitica_social_create_members_transfer_gems

Transfer Gems Parameters:

Parameter	Type	Required	Default	Description
`gemAmount`	integer	Yes	—	The number of gems to send
`message`	string	No	—	The message to the user
`toUserId`	string	Yes	—	The user to send the gift to

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "gemAmount": {
      "type": "integer",
      "description": "The number of gems to send"
    },
    "message": {
      "type": "string",
      "description": "The message to the user"
    },
    "toUserId": {
      "type": "string",
      "description": "The user to send the gift to"
    }
  },
  "required": [
    "PCID",
    "gemAmount",
    "toUserId"
  ]
}

habitica_social_delete_challenges_by_challenge_id

Delete a challenge Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	ID of the challenge to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "ID of the challenge to retrieve"
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_delete_groups_by_group_id_chat_by_chat_id

Delete chat message from a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`chatId`	string	Yes	—	The UUID of the chat message to delete.
`previousMsg`	string	No	—	The last message’s ID fetched by the client so that the whole chat will be returned only if new messages have been posted in the meantime.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "chatId": {
      "type": "string",
      "description": "The UUID of the chat message to delete."
    },
    "previousMsg": {
      "type": "string",
      "description": "The last message's ID fetched by the client so that the whole chat will be returned only if new messages have been posted in the meantime."
    }
  },
  "required": [
    "PCID",
    "groupId",
    "chatId"
  ]
}

habitica_social_get_challenges_by_challenge_id

Get challenges for a group Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	ID of the challenge to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "ID of the challenge to retrieve"
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_get_challenges_by_challenge_id_export_csv

Export Challenge to CSV Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	ID of the challenge to export

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "ID of the challenge to export"
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_get_challenges_by_challenge_id_members

Get members for a challenge Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	The UUID of the challenge whose members are to be retrieved.
`lastId`	string	No	—	Query parameter to specify the last member returned in a previous request to this route and get the next batch of results.
`limit`	integer	No	—	BETA Query parameter to specify the number of results to return. Max is 60.
`includeTasks`	boolean	No	—	BETA Query parameter - If ‘true’ then include challenge tasks of each member.
`includeAllPublicFields`	boolean	No	—	If set to true then all public fields for members will be returned (similar to when making a request for a single member).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "The UUID of the challenge whose members are to be retrieved."
    },
    "lastId": {
      "type": "string",
      "description": "Query parameter to specify the last member returned in a previous request to this route and get the next batch of results."
    },
    "limit": {
      "type": "integer",
      "description": "BETA Query parameter to specify the number of results to return. Max is 60."
    },
    "includeTasks": {
      "type": "boolean",
      "description": "BETA Query parameter - If 'true' then include challenge tasks of each member."
    },
    "includeAllPublicFields": {
      "type": "boolean",
      "description": "If set to true then all public fields for members will be returned (similar to when making a request for a single member)."
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_get_challenges_by_challenge_id_members_by_member_id

Get a challenge member progress Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	The ID of the challenge.
`memberId`	string	Yes	—	The ID of the challenge member.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "The ID of the challenge."
    },
    "memberId": {
      "type": "string",
      "description": "The ID of the challenge member."
    }
  },
  "required": [
    "PCID",
    "challengeId",
    "memberId"
  ]
}

habitica_social_get_challenges_groups_by_group_id

Get challenges for a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)."
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_get_challenges_user

Get challenges for a user Parameters:

Parameter	Type	Required	Default	Description
`page`	number	Yes	—	This parameter can be used to specify the page number for the user challenges result (the initial page is number 0).
`member`	string	No	—	If set to true it limits results to challenges where the user is a member.
`owned`	string	No	—	If set to owned it limits results to challenges owned by the user. If set to not_owned it limits results to challenges not owned by the user.
`search`	string	No	—	Optional query parameter to filter results to challenges that include (even partially) the search query parameter in the name or description.
`categories`	string	No	—	Optional comma separated list of categories. If set it limits results to challenges that are part of the given categories.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "number",
      "description": "This parameter can be used to specify the page number for the user challenges result (the initial page is number 0)."
    },
    "member": {
      "type": "string",
      "description": "If set to true it limits results to challenges where the user is a member."
    },
    "owned": {
      "type": "string",
      "description": "If set to owned it limits results to challenges owned by the user. If set to not_owned it limits results to challenges not owned by the user."
    },
    "search": {
      "type": "string",
      "description": "Optional query parameter to filter results to challenges that include (even partially) the search query parameter in the name or description."
    },
    "categories": {
      "type": "string",
      "description": "Optional comma separated list of categories. If set it limits results to challenges that are part of the given categories."
    }
  },
  "required": [
    "PCID",
    "page"
  ]
}

habitica_social_get_group_plans

Get Group Plans

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    }
  },
  "required": [
    "PCID"
  ]
}

habitica_social_get_groups

Get user’s groups Parameters:

Parameter	Type	Required	Default	Description
`type`	string	Yes	—	Type of groups to retrieve (party, guilds, privateGuilds, publicGuilds, tavern)
`paginate`	boolean	No	—	Whether to paginate the results (true or false)
`page`	integer	No	—	Page number for paginated results (if paginate is true)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "type": {
      "type": "string",
      "description": "Type of groups to retrieve (party, guilds, privateGuilds, publicGuilds, tavern)",
      "enum": [
        "party",
        "guilds",
        "privateGuilds",
        "publicGuilds",
        "tavern"
      ]
    },
    "paginate": {
      "type": "boolean",
      "description": "Whether to paginate the results (true or false)"
    },
    "page": {
      "type": "integer",
      "description": "Page number for paginated results (if paginate is true)"
    }
  },
  "required": [
    "PCID",
    "type"
  ]
}

habitica_social_get_groups_by_group_id

Get group information Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_get_groups_by_group_id_chat

Get group chat messages Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_get_groups_by_group_id_invites

Get invites for a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party is accepted)
`lastId`	string	No	—	Query parameter to specify the last invite returned in a previous request to this route and get the next batch of results.
`limit`	integer	No	—	BETA Query parameter to specify the number of results to return. Max is 60.
`includeAllPublicFields`	boolean	No	—	If set to `true` then all public fields for members will be returned (similar to when making a request for a single member).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party is accepted)"
    },
    "lastId": {
      "type": "string",
      "description": "Query parameter to specify the last invite returned in a previous request to this route and get the next batch of results."
    },
    "limit": {
      "type": "integer",
      "description": "BETA Query parameter to specify the number of results to return. Max is 60."
    },
    "includeAllPublicFields": {
      "type": "boolean",
      "description": "If set to `true` then all public fields for members will be returned (similar to when making a request for a single member)."
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_get_groups_by_group_id_members

Get members for a group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group id (‘party’ for the user party is accepted)
`lastId`	string	No	—	Query parameter to specify the last member returned in a previous request to this route and get the next batch of results.
`limit`	integer	No	—	BETA Query parameter to specify the number of results to return. Max is 60.
`includeTasks`	boolean	No	—	BETA Query parameter - If ‘true’ then include challenge tasks of each member.
`includeAllPublicFields`	boolean	No	—	If set to true then all public fields for members will be returned (similar to when making a request for a single member).

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group id ('party' for the user party is accepted)"
    },
    "lastId": {
      "type": "string",
      "description": "Query parameter to specify the last member returned in a previous request to this route and get the next batch of results."
    },
    "limit": {
      "type": "integer",
      "description": "BETA Query parameter to specify the number of results to return. Max is 60."
    },
    "includeTasks": {
      "type": "boolean",
      "description": "BETA Query parameter - If 'true' then include challenge tasks of each member."
    },
    "includeAllPublicFields": {
      "type": "boolean",
      "description": "If set to true then all public fields for members will be returned (similar to when making a request for a single member)."
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

habitica_social_get_groups_party_chat

Get party chat messages

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    }
  },
  "required": [
    "PCID"
  ]
}

habitica_social_get_looking_for_party

Get users in search of parties Parameters:

Parameter	Type	Required	Default	Description
`page`	number	No	—	Page number, defaults to 0.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page": {
      "type": "number",
      "description": "Page number, defaults to 0."
    }
  },
  "required": [
    "PCID"
  ]
}

habitica_social_get_members_by_member_id

Get habitica member by ID Parameters:

Parameter	Type	Required	Default	Description
`memberId`	string	Yes	—	ID of the member to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "memberId": {
      "type": "string",
      "description": "ID of the member to retrieve"
    }
  },
  "required": [
    "PCID",
    "memberId"
  ]
}

habitica_social_get_members_by_member_id_achievements

Get member achievements object Parameters:

Parameter	Type	Required	Default	Description
`memberId`	string	Yes	—	The ID of the member whose achievements are to be retrieved.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "memberId": {
      "type": "string",
      "description": "The ID of the member whose achievements are to be retrieved."
    }
  },
  "required": [
    "PCID",
    "memberId"
  ]
}

habitica_social_get_members_by_to_user_id_objections_by_interaction

Get objections to interaction Parameters:

Parameter	Type	Required	Default	Description
`toUserId`	string	Yes	—	The user to interact with
`interaction`	string	Yes	—	Name of the interaction to query.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "toUserId": {
      "type": "string",
      "description": "The user to interact with"
    },
    "interaction": {
      "type": "string",
      "description": "Name of the interaction to query.",
      "enum": [
        "send-private-message",
        "transfer-gems"
      ]
    }
  },
  "required": [
    "PCID",
    "toUserId",
    "interaction"
  ]
}

habitica_social_update_challenges_by_challenge_id

Update a challenge Parameters:

Parameter	Type	Required	Default	Description
`challengeId`	string	Yes	—	ID of the challenge to retrieve
`description`	string	No	—	The new challenge description.
`name`	string	No	—	The new full name of the challenge.
`summary`	string	No	—	The new challenge summary.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "challengeId": {
      "type": "string",
      "description": "ID of the challenge to retrieve"
    },
    "description": {
      "type": "string",
      "description": "The new challenge description."
    },
    "name": {
      "type": "string",
      "description": "The new full name of the challenge."
    },
    "summary": {
      "type": "string",
      "description": "The new challenge summary."
    }
  },
  "required": [
    "PCID",
    "challengeId"
  ]
}

habitica_social_update_groups_by_group_id

Update Group Parameters:

Parameter	Type	Required	Default	Description
`groupId`	string	Yes	—	The group _id (‘party’ for the user party and ‘habitrpg’ for tavern are accepted)
`name`	string	No	—	The name of the new group.
`privacy`	string	No	—	Privacy of group (party MUST be private)
`type`	string	No	—	Type of group (guild or party)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "groupId": {
      "type": "string",
      "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
    },
    "name": {
      "type": "string",
      "description": "The name of the new group."
    },
    "privacy": {
      "type": "string",
      "description": "Privacy of group (party MUST be private)",
      "enum": [
        "private",
        "public"
      ]
    },
    "type": {
      "type": "string",
      "description": "Type of group (guild or party)",
      "enum": [
        "guild",
        "party"
      ]
    }
  },
  "required": [
    "PCID",
    "groupId"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Skills Guides

Documentation Index

​Tools

​habitica_social_create_challenges

​habitica_social_create_challenges_by_challenge_id_clone

​habitica_social_create_challenges_by_challenge_id_join

​habitica_social_create_challenges_by_challenge_id_leave

​habitica_social_create_challenges_by_challenge_id_select_winner_by_winner_id

​habitica_social_create_groups

​habitica_social_create_groups_by_group_id_add_manager

​habitica_social_create_groups_by_group_id_chat

​habitica_social_create_groups_by_group_id_chat_by_chat_id_clearflags

​habitica_social_create_groups_by_group_id_chat_by_chat_id_flag

​habitica_social_create_groups_by_group_id_chat_by_chat_id_like

​habitica_social_create_groups_by_group_id_chat_seen

​habitica_social_create_groups_by_group_id_invite

​habitica_social_create_groups_by_group_id_join

​habitica_social_create_groups_by_group_id_leave

​habitica_social_create_groups_by_group_id_quests_abort

​habitica_social_create_groups_by_group_id_quests_accept

​habitica_social_create_groups_by_group_id_quests_cancel

​habitica_social_create_groups_by_group_id_quests_force_start

​habitica_social_create_groups_by_group_id_quests_invite_by_quest_key

​habitica_social_create_groups_by_group_id_quests_leave

​habitica_social_create_groups_by_group_id_quests_reject

​habitica_social_create_groups_by_group_id_reject_invite

​habitica_social_create_groups_by_group_id_remove_manager

​habitica_social_create_groups_by_group_id_remove_member_by_member_id

​habitica_social_create_groups_create_plan

​habitica_social_create_groups_party_chat

​habitica_social_create_members_send_private_message

​habitica_social_create_members_transfer_gems

​habitica_social_delete_challenges_by_challenge_id

​habitica_social_delete_groups_by_group_id_chat_by_chat_id

​habitica_social_get_challenges_by_challenge_id

​habitica_social_get_challenges_by_challenge_id_export_csv

​habitica_social_get_challenges_by_challenge_id_members

​habitica_social_get_challenges_by_challenge_id_members_by_member_id

​habitica_social_get_challenges_groups_by_group_id

​habitica_social_get_challenges_user

​habitica_social_get_group_plans

​habitica_social_get_groups

​habitica_social_get_groups_by_group_id

​habitica_social_get_groups_by_group_id_chat

​habitica_social_get_groups_by_group_id_invites

​habitica_social_get_groups_by_group_id_members

​habitica_social_get_groups_party_chat

​habitica_social_get_looking_for_party

​habitica_social_get_members_by_member_id

​habitica_social_get_members_by_member_id_achievements

​habitica_social_get_members_by_to_user_id_objections_by_interaction

​habitica_social_update_challenges_by_challenge_id

​habitica_social_update_groups_by_group_id

Tools

habitica_social_create_challenges

habitica_social_create_challenges_by_challenge_id_clone

habitica_social_create_challenges_by_challenge_id_join

habitica_social_create_challenges_by_challenge_id_leave

habitica_social_create_challenges_by_challenge_id_select_winner_by_winner_id

habitica_social_create_groups

habitica_social_create_groups_by_group_id_add_manager

habitica_social_create_groups_by_group_id_chat

habitica_social_create_groups_by_group_id_chat_by_chat_id_clearflags

habitica_social_create_groups_by_group_id_chat_by_chat_id_flag

habitica_social_create_groups_by_group_id_chat_by_chat_id_like

habitica_social_create_groups_by_group_id_chat_seen

habitica_social_create_groups_by_group_id_invite

habitica_social_create_groups_by_group_id_join

habitica_social_create_groups_by_group_id_leave

habitica_social_create_groups_by_group_id_quests_abort

habitica_social_create_groups_by_group_id_quests_accept

habitica_social_create_groups_by_group_id_quests_cancel

habitica_social_create_groups_by_group_id_quests_force_start

habitica_social_create_groups_by_group_id_quests_invite_by_quest_key

habitica_social_create_groups_by_group_id_quests_leave

habitica_social_create_groups_by_group_id_quests_reject

habitica_social_create_groups_by_group_id_reject_invite

habitica_social_create_groups_by_group_id_remove_manager

habitica_social_create_groups_by_group_id_remove_member_by_member_id

habitica_social_create_groups_create_plan

habitica_social_create_groups_party_chat

habitica_social_create_members_send_private_message

habitica_social_create_members_transfer_gems

habitica_social_delete_challenges_by_challenge_id

habitica_social_delete_groups_by_group_id_chat_by_chat_id

habitica_social_get_challenges_by_challenge_id

habitica_social_get_challenges_by_challenge_id_export_csv

habitica_social_get_challenges_by_challenge_id_members

habitica_social_get_challenges_by_challenge_id_members_by_member_id

habitica_social_get_challenges_groups_by_group_id

habitica_social_get_challenges_user

habitica_social_get_group_plans

habitica_social_get_groups

habitica_social_get_groups_by_group_id

habitica_social_get_groups_by_group_id_chat

habitica_social_get_groups_by_group_id_invites

habitica_social_get_groups_by_group_id_members

habitica_social_get_groups_party_chat

habitica_social_get_looking_for_party

habitica_social_get_members_by_member_id

habitica_social_get_members_by_member_id_achievements

habitica_social_get_members_by_to_user_id_objections_by_interaction

habitica_social_update_challenges_by_challenge_id

habitica_social_update_groups_by_group_id