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，只需填写该 URL，不要添加 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 集成

Ably MCP by usefulapi

io.usefulapi官方发布者

面向 Ably 实时消息的托管 MCP 服务器：查看频道历史、在线状态与占用情况，发布消息，并查看应用用量与配置。

Streamable HTTP可网页运行
云端与基础设施15 个工具Nov 7, 2026

Woffu MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手查询 Woffu 公司的用户、劳动合同、部门和办公地点。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapi官方发布者

面向 White Label Loyalty 的托管 MCP 服务器：浏览奖励、查看客户积分钱包与等级进度，并用积分购买奖励。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

Weekdone MCP by usefulapi

io.usefulapi官方发布者

托管的 Weekdone 连接器，让助手读取周报、团队、目标与 KPI，并新增报告条目、评论和 KPI 数值。

Streamable HTTP可网页运行
数据与分析15 个工具Nov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手列出 WebinarKit 的网络研讨会、场次时间、系列、会议以及白标子账户。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026