Skip to content
MCP server

Namely MCP by usefulapi

Read Namely employee profiles, groups, teams, jobs and reports; update profiles, post to…

Install
Runs
Remotely
Version
1.21.0
Listing updated
4 days ago

About Namely MCP by usefulapi

Namely MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://namely.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "namely": {
      "url": "https://namely.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (17)

Read directly from the server.

namely_get_me
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 (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 (lim
namely_get_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}.
namely_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 all groups (departments, office locations and other company groups). Every group belongs to one group type. Namely API: GET /groups.
namely_get_group
Get one group by id, with the profiles (members) linked to it. Namely API: GET /groups/{id}.
namely_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 all teams with their team categories. Namely API: GET /teams.
namely_get_team
Get one team by id, with the profiles (members) linked to it. Namely API: GET /teams/{id}.
namely_list_job_titles
List all job titles; each belongs to one job tier. Namely API: GET /job_titles.
namely_list_job_tiers
List all job tiers (the levels that group job titles). Namely API: GET /job_tiers.
namely_list_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.
namely_list_event_comments
List the comments on a feed event. Namely API: GET /events/{event-id}/comments.
namely_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}.
namely_update_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}.
namely_create_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.
namely_create_event_comment
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 MCP by usefulapi FAQ

How do I add Namely MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http namely https://namely.usefulapi.io/mcp