Monthly Downloads: 478
Programming language: Elixir
License: MIT License
Tags: Email    
Latest version: v0.1.17

gmail alternatives and similar packages

Based on the "Email" category

Do you think we are missing an alternative of gmail or a related project?

Add another 'Email' Package



Build Status Coverage Status hex.pm version hex.pm downloads Inline docs

A simple Gmail REST API client for Elixir.

You can find the hex package here, and the docs here.

You can find documentation for Gmail's API at https://developers.google.com/gmail/api/


First, add the client to your mix.exs dependencies:

def deps do
  [{:gmail, "~> 0.1"}]

Then run $ mix do deps.get, compile to download and compile your dependencies.

Finally, add the :gmail application as your list of applications in mix.exs:

def application do
  [applications: [:logger, :gmail]]

Before you can work with mail for a user you'll need to start a process for them.

{:ok, pid} = Gmail.User.start_mail("user@example.com", "user-refresh-token")

When a user process starts it will automatically fetch a new access token for that user. Then you can start playing with mail:

# fetch a list of threads
{:ok, threads, next_page_token} = Gmail.User.threads("user@example.com")

# fetch the next page of threads using a page token
{:ok, _, _} = Gmail.User.threads("user@example.com", %{page_token: next_page_token})

# fetch a thread by ID
{:ok, thread} = Gmail.User.thread("user@example.com", "1233454566")

# fetch a list of labels
{:ok, labels} = Gmail.User.labels("user@example.com")

Check the docs for a more complete list of functionality.

API Support

  • [ ] Threads
    • [x] get
    • [x] list
    • [ ] modify
    • [x] delete
    • [x] trash
    • [x] untrash
  • [ ] Messages
    • [x] delete
    • [x] get
    • [ ] insert
    • [x] list
    • [x] modify
    • [ ] send
    • [x] trash
    • [x] untrash
    • [ ] import
    • [ ] batchDelete
  • [x] Labels
    • [x] create
    • [x] delete
    • [x] list
    • [x] update
    • [x] get
    • [x] update
    • [x] patch
  • [ ] Drafts
    • [x] list
    • [x] get
    • [x] delete
    • [ ] update
    • [ ] create
    • [x] send
    • [ ] send (with upload)
  • [x] History
    • [x] list
  • [x] Attachments
    • [x] get (thanks to @killtheliterate)


As of now the library doesn't do the initial auth generation for you; you'll need to create an app on the Google Developer Console to get a client ID and secret and authorize a user to get an authorization code, which you can trade for an access token.

The library will however, when you supply a refresh token, use that to refresh an expired access token for you. Take a look in the dev.exs.sample config file to see what your config should look like.


  • [x] Stop mocking HTTP requests and use Bypass instead
  • [x] Add format option when fetching threads
  • [x] .. and messages
  • [ ] .. and drafts
  • [ ] Batched requests
  • [ ] Document the config (specifically pool size)