{"name":"io.github.mindstone/mcp-server-humaans","slug":"mindstone-mcp-server-humaans","title":"Humaans","description":"Humaans HR platform MCP server for Model Context Protocol hosts","url":"https://mcp.market/server/mindstone-mcp-server-humaans","rating":null,"grade":"A","score":85,"certified":false,"status":"active","category":"ai","tags":["ai"],"presence":{"score":36,"stars":14,"forks":4,"downloads_week":76,"last_push_at":"2026-11-04T07:07:50.000Z","license":"NOASSERTION"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/mindstone/mcp-servers","website":null,"version":"0.3.1","remotes":[],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@mindstone/mcp-server-humaans","version":"0.3.1","runtimeHint":"npx","transport":{"type":"stdio"},"environmentVariables":[{"description":"Humaans API access token (from app settings)","isRequired":true,"format":"string","isSecret":true,"name":"HUMAANS_API_KEY"}]}],"tools":[{"name":"approve_humaans_time_away","description":"Approve a pending time away request in Humaans (manager action). Sets the request status to approved. Use list_humaans_time_away with requestStatus=\"pending\" to find requests awaiting review. Example: { \"timeAwayId\": \"YLlqHE4DLvGtFJ7L2qro6bTF\" } RELATED TOOLS: - decline_humaans_time_away: Decline the request instead - list_humaans_time_away: Find pending requests","write_action":false,"price_micros":0,"input_schema":null},{"name":"cancel_humaans_time_away","description":"Cancel a time away entry in Humaans (deletes it permanently). Use this to withdraw a time off request or remove an incorrect entry. The deletion cannot be undone — confirm the entry with list_humaans_time_away first. Example: { \"timeAwayId\": \"YLlqHE4DLvGtFJ7L2qro6bTF\" } RELATED TOOLS: - list_humaans_time_away: Find the timeAwayId to cancel - create_humaans_time_away: Create a new request instead","write_action":true,"price_micros":0,"input_schema":null},{"name":"configure_humaans_api_key","description":"Host-managed setup only. The user adds the Humaans API access token in Settings → Connectors in the app. Do not ask for or accept the token in chat.","write_action":false,"price_micros":0,"input_schema":null},{"name":"create_humaans_time_away","description":"Create a time away request in Humaans (PTO, sick leave, etc.). WORKFLOW - To request time off: 1. Call get_humaans_me to get your personId 2. Call list_humaans_time_away_types to find the timeAwayTypeId (e.g., \"Paid time off\") 3. Call this tool with the details Dates must be in YYYY-MM-DD format. Use startPeriod/endPeriod for half days. COMMON MISTAKES: - Don't guess timeAwayTypeId - always get it","write_action":true,"price_micros":0,"input_schema":null},{"name":"decline_humaans_time_away","description":"Decline a pending time away request in Humaans (manager action). Sets the request status to declined. Consider including a reviewNote so the employee knows why. Example: { \"timeAwayId\": \"YLlqHE4DLvGtFJ7L2qro6bTF\", \"reviewNote\": \"Dates clash with the release freeze\" } RELATED TOOLS: - approve_humaans_time_away: Approve the request instead - list_humaans_time_away: Find pending requests","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_humaans_company","description":"Get company information from Humaans. Returns: company name, status, trial info, timesheet settings. Example: {}","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_humaans_job_role","description":"Get a specific job role by ID from Humaans. Returns: job title, department, manager (reportingTo), effectiveDate, endDate, note. Example: { \"jobRoleId\": \"hmA5GnUq9ojK86LLKKWbiuKG\" }","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_humaans_me","description":"Get the current authenticated user's profile from Humaans. Returns: name, email, job title, department, teams, location, status. Use this to get your own personId for other operations (e.g., creating time away). RELATED TOOLS: - create_humaans_time_away: Use the returned id as personId - list_humaans_time_away: Filter by your personId","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_humaans_person","description":"Get full employee profile from Humaans by their ID. Returns detailed profile including: name, email, job role, department, teams, location, employment dates, contract type, working days, manager, bio, social links. Sensitive fields (tax ID, personal email, home address) are redacted for privacy. Example: { \"personId\": \"VMB1yzL5uL8VvNNCJc9rykJz\" } WORKFLOW - To find a person: 1. Call list_humaans_p","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_humaans_job_roles","description":"List job role history for employees in Humaans. Each person can have multiple job roles over time. The role with the most recent effectiveDate that is not in the future is the current active role. Use the asOf parameter to find what role someone had at a specific date. Example: { \"personId\": \"VMB1yzL5uL8VvNNCJc9rykJz\" } RELATED TOOLS: - list_humaans_people: Find personId to filter by","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_humaans_locations","description":"List company locations/offices from Humaans. Returns: label, city, country, timezone for each office location. Note: Remote employees have locationId=\"remote\" with remoteCity/remoteCountry fields on their person profile. Example: {}","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_humaans_people","description":"List employees from Humaans HR. By default returns only active employees. Use status filter for other groups. Returns compact summaries: id, name, email, job title, department, teams, location, status. Example: { \"status\": \"active\", \"team\": \"Engineering\", \"limit\": 50 } Pagination: Returns up to 'limit' results (default 50, max 250). Use 'skip' for next page. RELATED TOOLS: - get_humaans_person: Pa","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_humaans_teams","description":"List team names in Humaans with member counts. Humaans has no dedicated teams endpoint, so this derives the team list by scanning the people directory. Use it to discover valid values for the 'team' filter on list_humaans_people. Example: {} RELATED TOOLS: - list_humaans_people: Filter employees by team name","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_humaans_time_away","description":"List time away (PTO, sick leave, etc.) entries from Humaans. Filter by person, date range, or approval status. Returns: dates, type, days count, approval status, notes. Example: { \"personId\": \"VMB1yzL5uL8VvNNCJc9rykJz\" } Example: { \"startDateAfter\": \"2024-01-01\", \"startDateBefore\": \"2024-12-31\" } RELATED TOOLS: - list_humaans_people: Find personId to filter by - list_humaans_time_away_types: See a","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_humaans_time_away_allocations","description":"List time away allocations in Humaans — which time off policy applies to each person, and from which date. Allocations link a person to a time away policy (the policy defines their allowance and balances). Use this to answer \"which PTO policy is Jane on?\" or \"who is on the US policy?\". Example: { \"personId\": \"VMB1yzL5uL8VvNNCJc9rykJz\" } RELATED TOOLS: - list_humaans_people: Find personId to filter","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_humaans_time_away_types","description":"List available time away types in Humaans. Returns type names and IDs (e.g., \"Paid time off\", \"Sick leave\", \"Working from home\"). You need the type ID to create a time away request. RELATED TOOLS: - create_humaans_time_away: Use the returned id as timeAwayTypeId","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":85,"grade":"A","scanned_at":"2026-11-04T14:39:54.078Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-11-04T14:39:54.005Z","components":{"code":{"score":25,"max":25,"notes":["33 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 0 days ago"]},"identity":{"score":9,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@mindstone/mcp-server-humaans","version":"0.3.1","found":true,"license":"FSL-1.1-MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-08-10T08:09:29.887Z","repositoryUrl":"git+https://github.com/mindstone/mcp-servers.git","weeklyDownloads":76}],"repo":{"found":true,"owner":"mindstone","repo":"mcp-servers","archived":false,"pushedAt":"2026-11-04T07:07:50Z","stars":14,"forks":4,"openIssues":27,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/58389135?v=4","ownerCreatedAt":"2019-12-01T11:21:22Z","license":"NOASSERTION"},"icon":{"url":"https://avatars.githubusercontent.com/u/58389135?v=4&s=128","source":"registry","width":128,"height":128},"presence":{"stars":14,"forks":4,"downloadsWeek":76,"license":"NOASSERTION","lastPushAt":"2026-11-04T07:07:50.000Z","score":36}}}},"grade_history":[],"reviews":[]}