MCP server
Namely MCP by usefulapi
Read Namely employee profiles, groups, teams, jobs and reports; update profiles, post to…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://namely.usefulapi.io/mcpInstall 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