# Roleora

> Roleora is a freemium MCP server for hiring and recruiting. Log, search and summarise your work history in Roleora from an AI tool. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://roleora.com/docs/mcp
- **MCP Registry name:** com.roleora/roleora
- **Categories:** [hiring and recruiting](https://ai-powered.com/categories/hiring-and-recruiting), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-22

## About

Roleora is a career record, and this server lets AI tools read it and suggest new entries. Tools can log a piece of work with a title, description and evidence such as a commit hash, pull request URL or ticket key.

Anything an AI logs arrives as a pending suggestion in your review inbox, marked as agent written. It does not count toward streaks or resume generation until you promote it. The AI tool cannot write to your record directly.

Sign-in goes through Roleora's own OAuth flow, with a consent page listing what the tool asks for. Cursor and the GitHub Copilot coding agent use a token you create yourself, valid for 90 days.

## Features

- **Suggest work entries:** Log work as a pending suggestion with evidence attached.
- **Review gate:** Suggestions wait in an inbox until you confirm, edit or discard them.
- **Search your record:** Find confirmed entries matching a query, up to 20 results.
- **Profile summary:** Get counts, top skills and completeness without contact details.
- **Many clients:** Works with Claude Code, claude.ai, ChatGPT, Cursor, Copilot and Gemini CLI.
- **Revocable access:** Disconnect a tool or revoke a token at any time.

## Good for

- Log finished work from a coding session
- Search past accomplishments for a review
- Gather material for a resume or cover letter
- Check profile completeness

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http roleora https://mcp.roleora.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.roleora.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "roleora": {
      "url": "https://mcp.roleora.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "roleora": {
      "type": "http",
      "url": "https://mcp.roleora.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "roleora": {
      "serverUrl": "https://mcp.roleora.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.roleora.com/mcp
```

Enter a Name (for example "Roleora"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "roleora": {
      "type": "http",
      "url": "https://mcp.roleora.com/mcp"
    }
  }
}
```

## Tools

- `log_work_entry`: Records one piece of work as a pending suggestion in your review inbox.
- `list_recent_entries`: Lists confirmed entries and unreviewed AI-logged ones.
- `search_entries`: Finds confirmed entries matching a query, capped at 20.
- `get_profile_summary`: Returns counts, top skills and profile completeness.
- `get_application_profile`: Reads application profile details.

## FAQ

### Can an AI tool edit my record directly?

No. Its entries are suggestions that you must confirm.

### Which tools are exposed?

Five, including log_work_entry and search_entries.

### Do I need an account?

Yes, with the same confirmed email you use in your AI tool.

### How long do static tokens last?

90 days, and you can hold five active tokens.

### Is Roleora free?

Roleora has a free plan, with paid plans for more usage or features.

### How do I add Roleora to Claude Code?

Run this command in your terminal: claude mcp add --transport http roleora https://mcp.roleora.com/mcp

### What are the best alternatives to Roleora?

The closest alternatives to Roleora are Ha MCP, Concord MCP, Reactive Resume, Dayfile.app and note1.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [Dayfile.app](https://ai-powered.com/mcp/dayfile-app): Dayfile.app is an open-source MCP server for productivity.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BetaOS](https://ai-powered.com/mcp/betaos): BetaOS is an MCP server for productivity.
- [Waffleiron: Career page jobs (Greenhouse, Lever, Ashby, Workday)](https://ai-powered.com/mcp/waffleiron-career-page-jobs-greenhouse-lever-ashby-workday): Waffleiron: Career page jobs (Greenhouse, Lever, Ashby, Workday) is a freemium MCP server for web search and scraping.
- [CollabSphere](https://ai-powered.com/mcp/collabsphere): CollabSphere is an MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/roleora
