for ai agents

agent skills

enable AI agents to work with your jottie notes using the agent skills specification. one line to install, instant access to your notes.

quick start

install the skill

for claude code

claude skill add https://jottie.io/.well-known/agent-skills/jottie-api

manual download

curl -O https://jottie.io/.well-known/agent-skills/jottie-api/SKILL.md

skill url

https://jottie.io/.well-known/agent-skills/jottie-api/SKILL.md

capabilities

what agents can do

create & manage notes

create new notes, update existing ones, organize with tags and entities

semantic search

find notes by meaning, not just keywords, using vector embeddings

chat with ai

ask questions about your notes and get contextual answers

auto-organization

notes are automatically tagged with people, places, dates, and topics

authentication

get api access

to use the jottie api, you'll need to set up oauth credentials:

1 go to settings → developers
2 create a new oauth application
3 use your client id and secret in the oauth flow

oauth authorization url

https://jottie.io/api/oauth/authorize?client_id=YOUR_ID&redirect_uri=YOUR_URI&scope=notes.read%20notes.write&response_type=code

examples

quick examples

create a note

curl -X POST https://jottie.io/api/v1/notes \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "meeting with sarah tomorrow at 3pm"}'

search notes

curl "https://jottie.io/api/search?q=meetings%20this%20week" \
  -H "Authorization: Bearer $TOKEN"

list all notes

curl https://jottie.io/api/v1/notes \
  -H "Authorization: Bearer $TOKEN"

resources

learn more

SKILL.md

the main skill file with instructions for agents

api reference

complete documentation for all api endpoints

openapi spec

machine-readable api specification

agent skills spec

learn about the agent skills format

need help?

questions about integrating with the jottie api? we're happy to help.