Skip to main content

Joplin (Markdown) Loader

pip install llama-index-readers-joplin

Joplin is an open source note-taking app. Capture your thoughts and securely access them from any device.

This readme covers how to load documents from a Joplin database.

Joplin has a REST API for accessing its local database. This reader uses the API to retrieve all notes in the database and their metadata. This requires an access token that can be obtained from the app by following these steps:

  1. Open the Joplin app. The app must stay open while the documents are being loaded.
  2. Go to settings / options and select "Web Clipper".
  3. Make sure that the Web Clipper service is enabled.
  4. Under "Advanced Options", copy the authorization token.

You may either initialize the reader directly with the access token, or store it in the environment variable JOPLIN_ACCESS_TOKEN.

An alternative to this approach is to export the Joplin's note database to Markdown files (optionally, with Front Matter metadata) and use a Markdown reader, such as ObsidianReader, to load them.

Usage

Here's an example usage of the JoplinReader.

import os

from llama_index.readers.joplin import JoplinReader

documents = JoplinReader(
    access_token="<access_token>"
).load_data()  # Returns list of documents

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llama_index_readers_joplin-0.7.0.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

llama_index_readers_joplin-0.7.0-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file llama_index_readers_joplin-0.7.0.tar.gz.

File metadata

  • Download URL: llama_index_readers_joplin-0.7.0.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for llama_index_readers_joplin-0.7.0.tar.gz
Algorithm Hash digest
SHA256 ccfe1cfb9053ba23136b065b7e77f373010be813912e86b535d8ad361aead6e7
MD5 25cb9c50000fbbf44f184ebf8c0f38c9
BLAKE2b-256 a43ebf85d51d8e42ed3f510e6bbc616d450e4f2916d6a7daf35ca02e6f1cbe40

See more details on using hashes here.

File details

Details for the file llama_index_readers_joplin-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: llama_index_readers_joplin-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 4.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for llama_index_readers_joplin-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b6fa5c1443144a0b18fcef2e5aa36710d539ff165a8d0e8b42102e8ee50a100b
MD5 07e1eec542e57e2eb95e0fb8885475fc
BLAKE2b-256 f2659cfa1623fabcf68a40de51eb1bc8308e54756e9831c69ac6972c2d135cf5

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.7.0 This release

2 files

0.6.1

2 files

0.6.0

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page