For Agents
Call Evernote's NoteStore and UserStore EDAM services over HTTPS to manage notes, notebooks, tags, and search via Thrift-encoded POST requests, with OAuth for authentication.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Evernote API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Evernote API API.
Create, retrieve, and update notes through the NoteStore EDAM service
Manage notebooks and tags using NoteStore Thrift operations
Run full-text and metadata searches against the user's note corpus
Authenticate users and inspect identity via the UserStore service
GET STARTED
Use for: Create a new note in a specific notebook, Search notes for a keyword across all notebooks, List all notebooks for the current user, Get information about the current Evernote user
Not supported: Does not expose REST resources for individual notebooks or tags — all note operations route through the NoteStore Thrift endpoint, so use this spec for EDAM service access only.
Jentic publishes the only available OpenAPI document for Evernote API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Evernote API, keeping it validated and agent-ready. Evernote uses a Thrift-based EDAM (Evernote Data Access and Management) protocol over HTTPS rather than a REST surface. The NoteStore service handles notes, notebooks, tags, and search; the UserStore service handles user identity and authentication. Calls are POST requests with Thrift-encoded bodies, so this OpenAPI spec captures the EDAM service endpoints and the OAuth flow — not a fine-grained per-resource REST surface.
Drive the OAuth flow to obtain an Evernote access token for a user
Integrate Evernote content into note-taking and knowledge-management agents
Patterns agents use Evernote API API for, with concrete tasks.
★ Note Capture from External Tools
Knowledge-management workflows pipe meeting summaries, articles, or chat highlights into Evernote so users have a single searchable archive. Calls go to POST /edam/notestore with a Thrift-encoded createNote payload, returning the note GUID for follow-on linking. Most teams wrap this in a thin client that handles the Thrift encoding once.
POST /edam/notestore with a Thrift-encoded createNote payload containing the meeting summary and target notebook GUID, then store the returned note GUID against the meeting record.
Cross-System Search and Recall
Tools that need to surface relevant notes inside other apps call NoteStore search operations to retrieve matching notes given a query. The shape lives behind POST /edam/notestore with a findNotes Thrift payload. Useful for sidebar widgets in CRMs or chat tools that bring user notes alongside the active record.
POST /edam/notestore with a Thrift-encoded findNotes call filtering on the customer name, then surface the top three matching notes inside the CRM contact view.
User Authentication and Account Linking
Apps that store data in a user's own Evernote account drive the OAuth flow via GET /oauth and use POST /edam/user to verify identity once the access token is granted. This is the gate for every per-user NoteStore call, since note operations execute against the user's account.
Drive GET /oauth to obtain a user access token, then POST /edam/user to fetch the user's profile and confirm the link before allowing NoteStore calls.
Agent-Driven Note Workflows
AI agents use Evernote through Jentic to capture notes from chat or browser actions and recall them later by intent. The Evernote OAuth token sits in the Jentic vault; agents only express intents like 'save this conversation as a note' or 'find my notes about onboarding'.
Search Jentic for 'create an Evernote note', load the POST /edam/notestore createNote operation, and execute it with the note title, body, and notebook GUID.
3 endpoints — jentic publishes the only available openapi specification for evernote api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/edam/notestore
NoteStore EDAM service for notes, notebooks, tags, and search
/edam/user
UserStore EDAM service for user and authentication operations
/oauth
OAuth flow to obtain a user access token
/edam/notestore
NoteStore EDAM service for notes, notebooks, tags, and search
/edam/user
UserStore EDAM service for user and authentication operations
/oauth
OAuth flow to obtain a user access token
Three things that make agents converge on Jentic-routed access.
Credential isolation
Evernote OAuth tokens are stored encrypted in the Jentic vault and injected at call time. Agents never see the raw token; refresh and revocation are centralised through Jentic.
Intent-based discovery
Agents search Jentic by intent (e.g. 'create an Evernote note' or 'search my notes') and Jentic returns the matching EDAM operation with its input schema, so the agent does not need to learn Thrift directly.
Time to first call
Direct Evernote integration: 2-3 days to handle OAuth, Thrift encoding, and EDAM exceptions. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Notion API
Notion offers a richer block-based knowledge base with a clean REST API.
Choose Notion when the workflow needs structured pages, databases, and a modern REST surface; choose Evernote when the user already lives in Evernote.
Microsoft To Do API
Microsoft To Do covers task and lightweight note workflows for users in the Microsoft ecosystem.
Choose Microsoft To Do when the user is in Microsoft 365; Evernote suits standalone note-taking workflows.
Dropbox API
Use Dropbox to store binary attachments referenced from Evernote notes.
Use Dropbox when the agent captures large file attachments alongside Evernote notes — store the file in Dropbox and link it from the note body.
Specific to using Evernote API API through Jentic.
Why is there no official OpenAPI spec for Evernote API?
Evernote does not publish an OpenAPI specification — its public API is delivered as a Thrift-based EDAM protocol. Jentic generates and maintains this OpenAPI spec so that AI agents and developers can call Evernote API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Evernote API use?
Evernote uses OAuth. The flow runs via GET /oauth to obtain a user access token, which is then passed alongside subsequent NoteStore and UserStore calls. Through Jentic the access token is stored encrypted in the vault.
Can I create notes with the Evernote API?
Yes — POST /edam/notestore accepts a Thrift-encoded createNote payload. The body must follow the EDAM Thrift schema; calling through Jentic abstracts most of the encoding work for the agent.
How do I search notes with the Evernote API?
POST /edam/notestore with a Thrift-encoded findNotes payload that includes the search filter and pagination parameters. The same NoteStore endpoint handles other note, notebook, and tag operations differentiated by the Thrift method.
What are the rate limits for the Evernote API?
Evernote applies per-user rate limits and returns EDAMSystemException with a rateLimitDuration when exceeded. The OpenAPI spec does not enumerate the limits — implement backoff using the rateLimitDuration value returned on the exception.
How do I create a note through Jentic?
Search Jentic for 'create an Evernote note', load the POST /edam/notestore createNote operation, and execute it with the note title, body, and notebook GUID. Jentic injects the OAuth token at execution time.