MCP server

Namely MCP by usefulapi

io.usefulapi/namely

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

17

Token cost

About 2,703 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http namely https://namely.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.namely]
url = "https://namely.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"namely":{"httpUrl":"https://namely.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"namely":{"url":"https://namely.usefulapi.io/mcp"}}}

VS Code

{"servers":{"namely":{"type":"http","url":"https://namely.usefulapi.io/mcp"}}}

Antigravity

agy mcp add namely https://namely.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"namely","server_url":"https://namely.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"namely","server_url":"https://namely.usefulapi.io/mcp"}

Tools

• namely_create_announcement ~252 tokens
  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) an
• namely_create_event_comment ~172 tokens
  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.
• namely_get_group ~100 tokens
  Get one group by id, with the profiles (members) linked to it. Namely API: GET /groups/{id}.
• namely_get_me ~81 tokens
  Get the profile of the user the connected token belongs to (name, email, job title, manager, access role). Namely API: GET /profiles/me.
• namely_get_profile ~144 tokens
  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}.
• namely_get_report ~139 tokens
  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}.
• namely_get_team ~98 tokens
  Get one team by id, with the profiles (members) linked to it. Namely API: GET /teams/{id}.
• namely_list_event_comments ~102 tokens
  List the comments on a feed event. Namely API: GET /events/{event-id}/comments.
• namely_list_events ~240 tokens
  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.
• namely_list_group_types ~76 tokens
  List the group types (the containers of groups, such as Department or Office). Namely API: GET /group_types.
• namely_list_groups ~83 tokens
  List all groups (departments, office locations and other company groups). Every group belongs to one group type. Namely API: GET /groups.
• namely_list_job_tiers ~68 tokens
  List all job tiers (the levels that group job titles). Namely API: GET /job_tiers.
• namely_list_job_titles ~68 tokens
  List all job titles; each belongs to one job tier. Namely API: GET /job_titles.
• namely_list_profile_fields ~100 tokens
  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_profiles ~488 tokens
  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,
• namely_list_teams ~62 tokens
  List all teams with their team categories. Namely API: GET /teams.
• namely_update_profile ~430 tokens
  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}.

Browse

• Converting to Markdown
• Email

Related MCP servers

• kiwiHR MCP by usefulapi
  Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.
• DeskMonitor
  DeskMonitor: 24 workforce-intelligence MCP tools, OAuth 2.1, free demo key included.
• Homebase MCP by usefulapi
  Read Homebase locations, employees, shifts, timecards, labor costs and time clock status.
• Shiftbase MCP by usefulapi
  Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.
• CharlieHR MCP by usefulapi
  Read CharlieHR team members, leave, allowances, offices, teams and salaries; add team member notes.
• Bilflo MCP by usefulapi
  Read Bilflo clients, contract jobs, contractors and reports; update jobs, terminate or reopen them.
• SupportBee MCP by usefulapi
  Read SupportBee tickets, replies and reports; reply, comment, label, assign and archive tickets.
• Papershift MCP by usefulapi
  Read Papershift absences, vacation, time tracking and shifts; request and review absences.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/namely.svg)](https://aptlynx.net/servers/io.usefulapi/namely)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents