rodnaph/gmailer

Clojure Gmail library

Gmailer

Gmailer is a Clojure library for using Gmail IMAP/SMTP via OAuth.

Installation

Gmailer is available from Clojars, so just add it as a dependency of your project.

DISCLAIMER: This is currently a README driven development work in progress, so nothing apart from the actual authentication really works yet.

:dependencies [[gmailer "0.0.1"]]

Usage

Gmailer assumes you already have a valid OAuth access token. Obtaining this access token is outside the scope of this library (but there is some info further down the page!). When you have the token though, it's easy to use:

(ns my.project
  (:require [gmailer.core as g]))

(def store (g/with-credentials "[email protected]" "ACCESS_TOKEN_HERE"
             (g/imap-store)))

(g/with-store store
  (println (take 5 (g/inbox))))

All access should be wrapped in the with-credentials macro.

Getting a Token

For development the easiest way to get an OAuth token is to go here:

https://developers.google.com/oauthplayground/

Then select Gmail from the API's listed on the left, and enter the scope:

https://mail.google.com/

Click authorise, grant permissions and you should be dumped on a page where you can click a button to exchange your authorisation token for a lovely new access token.