How to Connect Omni HR to ChatGPT, Claude or Cursor

Overview: 

Connecting your AI assistant to Omni HR takes about five minutes. The setup is the same idea across all three tools: give it a URL, sign in, done.

Important Notice:

This is an early version of MCP, so things may still be evolving.

Want access? Just email us at support@omnihr.co or reach out to your account manager — access isn't automatic and depends on your subscription's eligibility.

TABLE OF CONTENTS

• How to Connect Omni HR to ChatGPT
  • Step 1 — Turn on Developer Mode
  • Step 2 — Add Omni HR
  • Click > under Permissions.
  • Step 3 — Use it
• How to Connect Omni HR to Claude
  • Step 1 — Add Omni HR
  • Step 2 — Use it
• How to Connect Omni HR to Cursor
  • Step 1 — Add Omni HR
  • Step 2 — Use it
• How does sign-in to Omni HR work
• Keeping Things Secure: Quick Checklist
• How to troubleshoot when something is not working

How to Connect Omni HR to ChatGPT

ChatGPT needs Developer Mode turned on before you can add Omni HR. It's a one-time toggle — once it's on, you won't need to touch it again.

Step 1 — Turn on Developer Mode

1. Open ChatGPT in your browser and sign in.
2. Click your profile icon in the bottom left and pick Settings.
   
   
3. Go to Security and login.
4. Scroll to the bottom of the page to find developer mode. 
5. Enable Developer Mode.
   
   

Step 2 — Add Omni HR

1. Go to Plugins
   
   
2. Click the + icon on the right panel (besides the Search bar)
   
   
3. In New Plugin
   1. Choose Server URL for Connection
   2. Enter:

      Field	Value
      Name	Omni HR (or whatever you'd like to call it)
      Server URL	https://mcp.omnihr.co/mcp

      
      
   3. You'll get a warning about third-party servers — confirm it and move on.
      
      
4. Click Create
5. Sign in to your Omni HR workspace.
   
   
6. You're connected!
   
   
7. (Optional) You can set the permissions you would like. 

• Click > under Permissions.

(i) You will minimally need Always askor Allow read actionsif you want to make changes to information (i.e. submit time off). — ChatGPT will ask for approval before making the change.

(ii) If set to Allow low-risk actions: ChatGPT will automatically deny such actions without even asking for approval.

Step 3 — Use it

Open a new chat and start asking questions. That's it.

How to Connect Omni HR to Claude

Claude's setup is slightly different — you're adding a "connector" rather than an "app" — but it's just as quick.

Step 1 — Add Omni HR

1. Open the Claude Desktop App.
2. Go to Customize.
   
   
3. Go to Connectors.
4. Click Add custom connector.
   
   
5. Enter:
   
   

   Field	Value
   Name	Omni HR (or whatever you'd like to call it)
   Server URL	https://mcp.omnihr.co/mcp

   
   
6. Click Add.
7. Click Connect
   
   
8. Sign in to your Omni HR workspace.
9. Restart your Claude Desktop — this is the one extra step Claude needs that the others don't.
10. You're connected!
    
    

Step 2 — Use it

Open a new chat and start asking questions.

How to Connect Omni HR to Cursor

Cursor uses something called MCP servers — which sounds more technical than it is. You're just pasting a URL into a configuration file.

Step 1 — Add Omni HR

1. Open Cursor.
2. Click your profile icon in the bottom left and pick Settings.
   
   
3. Go to Tools & MCPs.
   
   
4. Under Home MCP Servers, click Add Custom MCP.
   
   
5. Add this tomcp.jsonfile:

   {
     "mcpServers": {
       "omnihr": {
         "url": "https://mcp.omnihr.co/mcp"
       }
     }
   }

6. Hit the kebab menu (the three dots) and save the file.
   
   
7. Click Connect.
   
   
8. Sign in to your Omni HR workspace.
9. When the browser asks you to allow access, go ahead and approve it.
   
   
10. You're connected!
    
    

Step 2 — Use it

Open a new chat and start asking questions.

How does sign-in to Omni HR work

For all AI Tools to successfully connect, you will need to sign-in to your Omni HR workspace either with email & password or Google SSO. Signing in with SSO isn't supported yet in this early release. 

Keeping Things Secure: Quick Checklist

Connecting an AI assistant to Omni HR gives it access to real employee data — the same information you can see and edit in your own account. Run through this checklist to stay safe.

How to troubleshoot when something is not working

This one's almost always one of four things:

Wrong URL	Double-check you're using exactly this — copy-paste it, don't retype: https://mcp.omnihr.co/mcp
Wrong Workspace	Make sure you signed in to the right Omni HR workspace during setup. If your company has multiple workspaces, it's easy to land in the wrong one.
Stale Connection	Remove the server and reconnect from scratch. This fixes most mystery issues.
AI cannot detect the bot (ChatGPT)	a. For ChatGPT Go to Settings > Plugin > click on the <Bot Name> You should be able to see a list of actions under developer mode section b. If you don’t, scroll all the way to the bottom to find the “Information” section → click  Refresh . It may take awhile to load all the tools. After the tools are loaded, you should be able to use the bot as expected.

If none of that worked, something unusual is going on — reach out to your Omni HR administrator and mention you've already tried the steps above.

Still Need Help?:

Reach out to our support team should you need further assistance.