Namely MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.17.4更新於 Nov 7, 2026

Read Namely employee profiles, groups, teams, jobs and reports; update profiles, post to the feed.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

面向 Namely 人力資源系統的託管 MCP 伺服器:讀取員工檔案、部門、團隊、職稱、動態與報表,並可更新檔案或發布公告。

可以做什麼
  • 查看自己的檔案,列出或取得員工檔案(含自訂欄位與敏感人事資料)
  • 瀏覽組織架構:群組、群組類型、團隊、職稱與職等及其成員
  • 讀取公司首頁動態:事件及其留言
  • 執行已儲存的 Namely 報表並取得其欄與列
  • 修改檔案的標準欄位,如姓名、電子郵件、到職日、狀態、主管與職稱
  • 向公司動態發布公告,並對動態事件留言
適用情境
適合讓助理回答關於公司人事資料的問題,例如誰向誰報告、某部門成員、到職日或即將到來的週年紀念;也適合做小幅人事紀錄更新與發布公司公告。
執行需求
遠端端點 namely.usefulapi.io/mcp,只需填入該網址,不要加入 API 金鑰或 Authorization 標頭。登入使用 OAuth,登入頁會要求填寫 Namely 站台名稱與個人存取權杖。免費方案每月 50 次工具呼叫,另有付費方案。
安裝前請注意
寫入類工具會改動線上人事資料:namely_update_profile 會修改員工紀錄,namely_create_announcement 會向全公司發布,且在設定 email_all 時會寄信給所有在職員工。檔案與報表可能包含薪酬、薪資歷史等敏感人事資料。付費方案需付費並透過付款連結結帳,取消後當期不退費。你的 Namely 資料會經過第三方託管服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Namely MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fnamely/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "namely-by-usefulapi": {
      "type": "http",
      "url": "https://namely.usefulapi.io/mcp"
    }
  }
}

README

Namely MCP by usefulapi

Read Namely employee profiles, groups, teams, jobs and reports; update profiles, post to the feed.

Live endpoint: https://namely.usefulapi.io/mcp · Homepage: https://usefulapi.io/namely

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://namely.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http namely https://namely.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "namely": {      "url": "https://namely.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Namely credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/namely/

On first connect you'll enter your Namely site name (acme for acme.namely.com) and a Personal Access Token.

Tools

ToolTypeWhat it does
namely_get_mereadGet my profile
namely_list_profilesreadList employee profiles
namely_get_profilereadGet employee profile
namely_list_profile_fieldsreadList profile fields
namely_list_groupsreadList groups
namely_get_groupreadGet group
namely_list_group_typesreadList group types
namely_list_teamsreadList teams
namely_get_teamreadGet team
namely_list_job_titlesreadList job titles
namely_list_job_tiersreadList job tiers
namely_list_eventsreadList feed events
namely_list_event_commentsreadList event comments
namely_get_reportreadGet report
namely_update_profilewriteUpdate employee profile
namely_create_announcementwritePost announcement
namely_create_event_commentwriteComment on event
namely_usage_statusmetaUsage status (free-tier meter)
namely_request_featuremetaRequest a missing feature
namely_upgrademetaUpgrade to Pro or Pro+
namely_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with namely_upgrade (it returns a Stripe Checkout link). Cancel any time with namely_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running namely_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Namely.

來源:servers/namely/README.md,提交 4046075

工具

17

namely_get_me

Get my profile

Get the profile of the user the connected token belongs to (name, email, job title, manager, access role). Namely API: GET /profiles/me.

無需輸入參數。

namely_list_profiles

List employee profiles

List employee profiles (active, pending and inactive unless filtered) with paging, sorting and filters. Returns {profiles, meta:{count}, linked}. Use format=short for a smaller record (ids, names, email, status, job title); the full record includes every custom field the token may see (compensation, addresses and other sensitive HR data). An empty page means the end. Namely API: GET /profiles (limit 100 requests per minute).

輸入參數pagesortemailformatper_pagejob_titlelast_namefirst_namereports_touser_statuspersonal_email

namely_get_profile

Get employee profile

Get one employee's full profile by id: personal and job data, manager, groups, teams and the custom fields the token may see (can include compensation and other sensitive HR data). Namely API: GET /profiles/{id}.

輸入參數id必填

namely_list_profile_fields

List profile fields

List the fields of the employee profile as configured at this company (standard and custom), with their labels, sections and the valid format of each value. Namely API: GET /profiles/fields.

無需輸入參數。

namely_list_groups

List groups

List all groups (departments, office locations and other company groups). Every group belongs to one group type. Namely API: GET /groups.

無需輸入參數。

namely_get_group

Get group

Get one group by id, with the profiles (members) linked to it. Namely API: GET /groups/{id}.

輸入參數id必填

namely_list_group_types

List group types

List the group types (the containers of groups, such as Department or Office). Namely API: GET /group_types.

無需輸入參數。

namely_list_teams

List teams

List all teams with their team categories. Namely API: GET /teams.

無需輸入參數。

namely_get_team

Get team

Get one team by id, with the profiles (members) linked to it. Namely API: GET /teams/{id}.

輸入參數id必填

namely_list_job_titles

List job titles

List all job titles; each belongs to one job tier. Namely API: GET /job_titles.

無需輸入參數。

namely_list_job_tiers

List job tiers

List all job tiers (the levels that group job titles). Namely API: GET /job_tiers.

無需輸入參數。

namely_list_events

List feed events

List events of the company home feed (announcements, birthdays, work anniversaries, new arrivals), newest first by default, with limit and after (an event id) for paging. Namely API: GET /events.

輸入參數typeafterlimitorderprofile_id

namely_list_event_comments

List event comments

List the comments on a feed event. Namely API: GET /events/{event-id}/comments.

輸入參數event_id必填

namely_get_report

Get report

Run a saved Namely report by id and return its columns and rows (live data; each row is a list in column order). Find the id in the URL of the report in Namely. Reports can contain sensitive HR data such as salary history. Namely API: GET /reports/{id}.

輸入參數id必填

namely_update_profile

Update employee profile

Change standard fields of an employee profile (name, emails, start date, status, manager, job title). WRITES live HR data. Send only the fields to change. Setting user_status to pending needs a personal_email. Namely API: PUT /profiles/{id}.

輸入參數id必填emailjob_titlelast_namefirst_namereports_tostart_dateuser_statuspersonal_email

namely_create_announcement

Post announcement

Post an announcement to the company home feed, visible to every employee. Markdown; to mention a person write [Full Name](/people/<profile_id>). With is_appreciation, mentioned people are appreciated. email_all=true ALSO EMAILS every active employee at their company address (needs the permission) and cannot be undone: set it only when the user explicitly asks. Namely API: POST /events.

輸入參數content必填email_allis_appreciation

namely_create_event_comment

Comment on event

Add a comment to a feed event, posted as the token's user and visible to employees who see the event. Markdown; mention a person with [Full Name](/people/<profile_id>). Namely API: POST /events/{id}/comments.

輸入參數content必填event_id必填

版本歷史

15
  1. v1.17.4最新Nov 7, 2026
  2. v1.16.3Nov 5, 2026
  3. v1.16.2Nov 5, 2026
  4. v1.16.1Nov 4, 2026
  5. v1.16.0Nov 3, 2026
  6. v1.15.1Nov 3, 2026
  7. v1.14.0Nov 1, 2026
  8. v1.12.0Oct 31, 2026
  9. v1.11.0Oct 31, 2026
  10. v1.10.2Oct 30, 2026
  11. v1.10.0Oct 30, 2026
  12. v1.5.0Oct 26, 2026
  13. v1.2.3Oct 25, 2026
  14. v1.2.0Oct 25, 2026
  15. v1.1.0Oct 24, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合