Dev Evernote Evernote API

Name: Evernote API
Brand: Evernote API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentProductivityNote Takingoauth23 EndpointsREST

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.

Install Jentic One Beta

Connect the Evernote API to your agent

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.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# 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 instance

Jentic 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.

Capabilities

What an agent can do with Evernote 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

GET STARTED

Start building with Evernote API

Explore with Jentic

View OpenAPI Document

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.

Use Cases

Patterns agents use Evernote 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.

Key Endpoints

3 endpoints — jentic publishes the only available openapi specification for evernote api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/edam/notestore

NoteStore EDAM service for notes, notebooks, tags, and search

POST

/edam/user

UserStore EDAM service for user and authentication operations

GET

/oauth

OAuth flow to obtain a user access token

POST

/edam/notestore

NoteStore EDAM service for notes, notebooks, tags, and search

POST

/edam/user

UserStore EDAM service for user and authentication operations

GET

/oauth

OAuth flow to obtain a user access token

Why Jentic?

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.

FAQs

Specific to using Evernote 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.

Dev Evernote Evernote API

Connect the Evernote API to your agent

Capabilities

Start building with Evernote API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs