mcpField
P
pachca-profile

pachca-profile

github.com/pachcaProductivity1188 installsUpdated today
Repository

About pachca-profile

pachca-profile is a skill for using the Pachca CLI to retrieve and update a user's profile. It covers profile details, custom properties, status, and avatar management.

Key features

  1. 01Retrieve profile details
  2. 02Inspect token scopes and expiry
  3. 03Set or clear user status
  4. 04List custom profile properties
  5. 05Upload or delete profile avatar

Use cases

  1. 01Check which scopes a token has
  2. 02Set an away status with an expiry
  3. 03Review employee custom properties

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pachca/openapi --skill pachca-profile

After installing, type/pachca-profilein Claude Code to confirm it loaded.

Details

From the project README

pachca-profile

Quick start

Ask the user for a Pachca token (bot: the API tab of the bot in Integrations → Bots, user: Integrations → API).

Run commands via npx -y @pachca/cli with the --token flag:

npx -y @pachca/cli <command> --token $PACHCA_TOKEN

Or set the PACHCA_TOKEN environment variable:

export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>

Help: npx -y @pachca/cli --help | Workflows: npx -y @pachca/cli guide

After successful use, suggest installing CLI globally: npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

Before you start

  1. If the user has a saved profile — check:

    npx -y @pachca/cli auth status

    If OK — run commands without --token.

  2. If no profile is configured — ask for a token and use --token:

    npx -y @pachca/cli auth status --token $PACHCA_TOKEN

  3. If you don't know the parameters — run pachca <command> --help.

Workflows

Получить свой профиль
  1. Получи информацию о текущем пользователе: 
    pachca profile get

Возвращает id, first_name, last_name, nickname, email, phone_number, department, title, role, suspended, invite_status, list_tags, custom_properties, user_status, bot, sso, created_at, last_activity_at, time_zone, image_url.

Проверить свой токен
  1. Получи информацию о токене: скоупы, дату создания, срок жизни: 
    pachca oauth token-info

Полезно для диагностики: какие скоупы доступны токену, когда он истекает.

Установить статус
  1. Установи статус: 
    pachca profile update-status --emoji="🏖️" --title="В отпуске" --is-away --away-message="Я в отпуске до 10 марта" --expires-at="2025-03-10T23:59:59.000Z"

    is_away: true — режим «Нет на месте». expires_at — автосброс (ISO-8601, UTC+0). away_message — макс 1024 символа

Сбросить статус
  1. Удали статус: 
    pachca profile delete-status --force
Получить кастомные поля профиля

  1. Получи список дополнительных полей для сотрудников:

    pachca custom-properties list --entity-type=User

    Добавь entity_type=User для фильтрации

  2. Получи профиль — в custom_properties содержатся значения полей:

    pachca profile get

Кастомные поля настраиваются администратором пространства.

Загрузить аватар профиля
  1. Загрузи аватар из файла: 
    pachca profile update-avatar --file=<путь_к_файлу>

    Файл изображения передается в формате multipart/form-data

Удалить аватар профиля
  1. Удали аватар: 
    pachca profile delete-avatar --force

Limitations

  • Rate limit: ~50 req/sec. On 429 — wait and retry.
  • status.title: max 50 characters
  • status.away_message: max 1024 characters
  • Pagination: cursor-based (limit + cursor)

Endpoints

MethodPathDescription
GET/custom_propertiesСписок дополнительных полей
GET/profileСвой профиль
PUT/profile/avatarЗагрузка своего аватара
DELETE/profile/avatarУдаление своего аватара
GET/profile/statusСвой статус
PUT/profile/statusНовый свой статус
DELETE/profile/statusУдаление своего статуса

If unsure how to complete a task, read the corresponding file from references/.

Comments

Markdown supported