[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Add notes to Lever candidate profiles with AI

> Turn call summaries into Lever notes with @mentions and tags, on the right candidate profile, from Claude Code or a script.

Source: https://cotlet.dev/integrations/lever-api-mcp-server/log-notes-on-candidate-profiles

A recruiter finishes a call, pastes rough bullets into a chat and still has to open Lever, find the profile, type the note, @mention the hiring manager and add a tag.

Cotlet does it in your own Lever account with list\_opportunities, get\_opportunity, add\_note and update\_tags, called by your AI agent, an n8n workflow or a script.

[Sign up free](https://cotlet.dev/app/signup?app=lever) [All Lever tools](https://cotlet.dev/integrations/lever-api-mcp-server.md)

Hosted · nothing to install or maintain

## Can Lever do this on its own?

Lever's Data API creates notes with @mentions, a secret flag and notifyFollowers (POST /opportunities/:opportunity/notes) for customers with an API key, and has no MCP server (checked 22 Oct 2026). In the app, a note is typed on the profile itself.

## How you do it in Lever today

1. At the top of the candidate profile, click the Add note field and type. Check Notify followers to alert followers, then click Add note.
2. To get a colleague's attention, type @ and the user's name and pick them from the pop-over. Only users added to Lever can be mentioned.
3. To keep a note private, click the toggle in the lower left corner of the note box to make it a secret note.
4. Notes from all of the candidate's opportunities are listed together in the story on the profile, newest first.
5. Lever emails every @-mentioned user and the user cannot switch those emails off, so a wrong mention lands in someone's inbox.

## How to add notes to Lever candidate profiles with AI

Prompt

```
Add this to the Lever profile of aisha.khan@example.com: "Call 22 Oct: wants hybrid, two weeks notice, salary band fits." Mention Sam Okafor and tag her strong-referral.
```

1. 01  
### Find the profile  
list\_opportunities runs with the candidate email from your prompt. When the email matches more than one opportunity, the agent asks which posting you mean instead of choosing.
2. 02  
### Check where the note lands  
get\_opportunity shows the stage, posting and followers, so the agent can tell you where the note goes before writing it.
3. 03  
### Write the note  
The agent keeps your words and tightens them to short lines. It mentions only the users your prompt names, written as @name the way Lever expects, and marks the note secret only when you say so.
4. 04  
### Save the note  
add\_note saves it on the opportunity. It waits for your OK by default, because a mention emails the person at once.
5. 05  
### Tag the candidate  
update\_tags adds the tags you named. It reaches nobody and is undone by one call, so it does not wait for your OK.

### What you get back

Example data

```
Aisha Khan, Senior Designer, stage Recruiter screen
Note added, not secret, Sam Okafor mentioned
Followers not notified
Tags now: portfolio-strong, strong-referral
```

### Other ways to ask

- After every call I paste here, add the summary as a secret note and mention nobody.
- Add this debrief to Marco Silva and Tom Becker and notify followers.
- Tag everyone I list with talent-pool and add one line saying why.

## What Lever allows, and what to know first

- Lever lists the Super Admin, Admin, Team Member and Limited Team Member roles for adding notes, so the account behind this job needs one of them.
- A secret note is visible only to users with Sensitive Information Privileges for the candidate's postings and to users who are @-mentioned in it.
- A user with Interviewer access who is @-mentioned receives the note by email but cannot open the candidate profile.
- Lever sends the email to a mentioned user even when that user turned off every notification type.

add\_note asks for your OK by default. To run it daily without you, switch confirmation off for that tool in your dashboard.

Sources: [Lever Help: Adding and managing notes](https://help.lever.co/hc/en-us/articles/20087386240157-Adding-and-managing-notes) · [Lever Developer: API Overview](https://hire.lever.co/developer/documentation)

## Call add\_note from a script

curl

```
curl -X POST https://cotlet.dev/api/v1/lever/opportunities/5c3d8a17-e2b4-49f6-8d01-7a9b6c4e2f05/notes \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Call 22 Oct: wants hybrid, two weeks notice, salary band fits. @sam please review her portfolio.","secret":false,"notify_followers":false}'
```

Example response

```
{
"note_id": "e5b09a72-4c18-4d63-9f2a-6a1c8d3b7e90",
"opportunity_id": "5c3d8a17-e2b4-49f6-8d01-7a9b6c4e2f05",
"secret": false,
"mentioned": [
"Sam Okafor"
],
"followers_notified": false,
"created_at": "2026-10-22T09:20:00Z"
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is lever\_write → add\_note. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/lever-api-mcp-server.md#automations)

## Lever tools this automation uses

__Cotlet Lever tools used to add notes to Lever candidate profiles with AI__
| Tool | Parameters |
| ------------------- | ------------------------------------------------ |
| list\_opportunities | posting\_id, stage, tag, email, archived, cursor |
| get\_opportunity | opportunity\_id |
| add\_note | opportunity\_id, text, secret, notify\_followers |
| update\_tags | opportunity\_id, add, remove |

[All 12 Lever tools with descriptions](https://cotlet.dev/integrations/lever-api-mcp-server.md#tools)

## Frequently asked questions

### Is it safe to connect Lever to Cotlet?

Yes. You sign in to Lever yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Lever once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

## More Lever automations

- [Archive rejected Lever candidates with a reason and email](https://cotlet.dev/integrations/lever-api-mcp-server/archive-rejected-candidates.md)
- [Advance Lever candidates after positive interview feedback](https://cotlet.dev/integrations/lever-api-mcp-server/advance-candidates-after-feedback.md)
- [Lever API and MCP server: every tool](https://cotlet.dev/integrations/lever-api-mcp-server.md)
- [All use cases](https://cotlet.dev/use-cases.md)

## Give your agent access to Lever.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Lever.

[Sign up free](https://cotlet.dev/app/signup?app=lever)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.

## For AI agents: sign your user up

Is your user asking you to sign them up for Cotlet? You can do it for them, no account or key needed.

1. Read the fields and their allowed values: GET https://cotlet.dev/api/v1/access-requests
2. Ask the user for each value: email, apps, what you will do with them. If they leave the password to you, generate a strong one and show it to them.
3. Show the user what you will send, then POST it as JSON to https://cotlet.dev/api/v1/access-requests.

One call creates the account and sends the access request; we email the user when access is granted.