When trying to fetch for new emails with .mail(unread=True, prefetch=True) when there's no unread emails, this error is thrown. It does not appear if I don't pass unread or prefetch, but together, it happens.

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/local/lib/python2.7/dist-packages/gmail/mailbox.py", line 64, in mail
    self.messages.update(self.gmail.fetch_multiple_messages(messages_dict))
  File "/usr/local/lib/python2.7/dist-packages/gmail/gmail.py", line 145, in fetch_multiple_messages
    response, results = self.imap.uid('FETCH', fetch_str, '(BODY.PEEK[] FLAGS X-GM-THRID X-GM-MSGID X-GM-LABELS)')
  File "/usr/lib/python2.7/imaplib.py", line 772, in uid
    typ, dat = self._simple_command(name, command, *args)
  File "/usr/lib/python2.7/imaplib.py", line 1087, in _simple_command
    return self._command_complete(name, self._command(name, *args))
  File "/usr/lib/python2.7/imaplib.py", line 917, in _command_complete
    raise self.error('%s command error: %s %s' % (name, typ, data))
imaplib.error: UID command error: BAD ['Could not parse command']

Sample code:

g = gmail.login("user", "pass")
inbox = g.inbox()
mail = inbox.mail(unread=True, prefetch=True)

I'm not 100% sure if this is a problem on my end/something I'm doing wrong, or on the module's end. Hopefully it is easily fixable!

This issue leads to mail subjects that are encoded not properly showing, instead having strings like
=?UTF-8?Q?
or
=?ISO-8859-1?B?
in their content.

> m.fetch()
> m.fr
# null

it looks for the m.message['fr'] key, but when I fetch mails from GMail, the key is m.message['From']

I have the library on my ubuntu cloud and it works fine
When installing on my raspberry pie I get this error
AttributeError: 'module' object has no attribute 'login'
Any clue?

I couldn't find a way to retrieve FROM email address of a message.
After analysing, I just figured out a way to get it. I just parsed the headers dict., split the required string and extracted the email address.

Here is a code snippet that I've added in Message class in message.py :

def get_from_address(self):
authHeader = self.headers["Authentication-Results"]
emailString = authHeader.split(";")[1]
tempList = emailString.split("=")
return tempList[len(tempList)-1]

It works. But its purely a dirty fix, I agree.
Is there any better alternative ?

Hi, how do we work when we have a thread of email from same person which has also been cc to someone.
Can we know the cc person ? Also, does mail.read() reads all the emails in the thread ?

Thanks

When an email is accessed as part of a label search, attempting to delete the email only removes the label from the email, but does not delete it.

An example for an email with the tags Inbox and Travel:

for email in g.label('Travel').mail()[0:1]:
    email.fetch()
    process(email.body)
    email.delete

This results in an email that still has the Inbox tag

Traceback (most recent call last):
File "email.py", line 2, in
import gmail
File "build/bdist.linux-armv6l/egg/gmail/init.py", line 16, in
from .gmail import Gmail
File "build/bdist.linux-armv6l/egg/gmail/gmail.py", line 4, in
File "build/bdist.linux-armv6l/egg/gmail/mailbox.py", line 1, in
"""Read/write support for Maildir, mbox, MH, Babyl, and MMDF mailboxes."""
File "build/bdist.linux-armv6l/egg/gmail/message.py", line 2, in
File "/home/pi/AirConRemote/email.py", line 8, in
g = gmail.login(username, password)
AttributeError: 'module' object has no attribute 'login'

Note: The 'username' and 'password' have been hidden for security reasons.
However it works by using python in command line.

Three questions all of which are related to how the data is returned once fetched.

1. Is there some documentation on the different pieces of information retrieved with the message? I'm looking to return the body of the message .body, who sent it, content-transfer encoding, etc. I'm using some google aliases and want to separate things out and need both the message and the sender returned.

2. Along the same lines, could the object returned be simplified into a dict? That would make driving through the data a little easier although potentially cumbersome if you pull a large number of emails.

3. You might consider adding some base64 code to decode the message. If you return a dict and see the content-transfer-encoding = 64 you could call the following type of "fix" for the text.

Example:
Content-Transfer-Encoding: base64
text=base64.decodestring(messages[0].body)

Great project!

I attempted logging in from my terminal/Ipython and got this message:

Sign-in attempt prevented ... Someone just tried to sign in to your Google Account [email protected] from an app that doesn't meet modern security standards.

Seem like I probably need to update a package used for authenticating, but not sure what exactly. Any suggestions?

I want to find out how many mails I reply back. Is it possible now?

How to query mailbox using message_id or thread_id ?
I checked find() method but I see there is no provision to filter emails by message_id or thread_id.

This is a difficult problem to solve. Multipart content is barely handled well at all presently.

Is there a way to mark an email as not spam using this API?

For now, loading payload when Attachment object created is default behavior.

I want to get for example all the letters relating to the social tab, or unsorted only.
There is a possibility, or write your own?

If there is a mail with attachment in uuencode format in my mailbox, the gmail message shows that there is not attachment and returns body with uuencoded attachment in it.
Could you please fix it?

This is an excellent module and I'd like to base some work on it to create a client, but is the development still ongoing ?

What are the dependencies required for the package to work? Consider adding a requirements.txt file?

This module is very useful for me, but this version of module does not support to send mail.

Another module is needed to send mail via google SMTP, so sending mail function is needed in this module.

I decided to write a little email filter to run on my vps and I ran into an interesting problem:

Traceback (most recent call last):
File "mailfilter.py", line 19, in
mail.read()
File "/usr/local/lib/python2.7/dist-packages/gmail-0.0.5-py2.7.egg/gmail/message.py", line 41, in read
self.gmail.imap.uid('STORE', self.uid, '+FLAGS', flag)
File "/usr/lib/python2.7/imaplib.py", line 760, in uid
typ, dat = self._simple_command(name, command, *args)
File "/usr/lib/python2.7/imaplib.py", line 1070, in _simple_command
return self._command_complete(name, self._command(name, *args))
File "/usr/lib/python2.7/imaplib.py", line 905, in _command_complete
raise self.error('%s command error: %s %s' % (name, typ, data))
imaplib.error: UID command error: BAD ['Could not parse command']

https://gist.github.com/anonymous/bd96cbcd768ce9c2647d
This is my code.

The problem seems to be that after running the filter once, it works as expected. The unwanted behaviour pops up if you run it multiple times if there are no items left matching the criteria, instead of holding 0 or None emails contains 1 message object, which I checked many times against my actual gmail account is not there. This falls automatically through the len() check and causes problems if you start calling methods on this "fake" message object. With message_id = None and no uid.

Is there a way to avoid the parse of the html in the body? I would like to retrieve the raw message instead. Since it's bad parsed due to outlook strange html tags.

Some people turn on 2-step authentication. It doesn't look like this library supports that, although I may be missing something. This post or this one may be of use.

Attachment handling forces the application to exit with the following error:

  File "lib/gmail/gmail/message.py", line 171, in fetch
    self.parse(results[0])
  File "lib/gmail/gmail/message.py", line 164, in parse
    self.attachments = [Attachment(attachment) for attachment in self.message._payload if attachment.get('Content-Disposition') is not None]
AttributeError: 'str' object has no attribute 'get'

I'm using the gmail library as part of an application that gets run regularly (every couple of minutes) through cron. Every once in a while (once every couple of hours), I see something like this in the cron logs:

Traceback (most recent call last):
  File "/home/misha/git/supersaas2google/check.py", line 86, in <module>
    main()
  File "/home/misha/git/supersaas2google/check.py", line 73, in main
    g = gmail.authenticate(USERNAME, credentials.access_token)
  File "/usr/local/lib/python2.7/dist-packages/gmail-0.0.5-py2.7.egg/gmail/utils.py", line 12, in authenticate
    gmail.authenticate(username, access_token)
  File "/usr/local/lib/python2.7/dist-packages/gmail-0.0.5-py2.7.egg/gmail/gmail.py", line 121, in authenticate
    raise AuthenticationError
gmail.exceptions.AuthenticationError

I don't understand why it fails only some of the time, but works for the rest of the time.

Do you have any ideas about what the problem could be?

I want to list messages and their attachments and then (if I want to) to download attachement. Now on command email.fetch() I download everything.
Can I separate them?

No module named 'utf'
python3

It seems this repo has been abandoned?

I'm working on a project using this library and it splits labels like "deductable expense" into two labels.

When I was adding the fetch_thread() functionally which uses several mailboxes in one function, I noticed that you must take good care of which is "current." This is confusing to work with and could introduce some mysterious bugs. I'll look into refactoring things so that all functions that require a mailbox to work explicitly take that as an arg. If anyone sees anything wrong with this idea, speak up.

When I try to import the lib with Python 3.7.

ModuleNotFoundError: No module named 'exceptions'

Problem occurs when I get multiple emails and then loop through them and try to add the a label to each email.

example:

mails = g.inbox().mail(sender=sender, prefetch=True)
for m in mails:
   m.add_label("Label")

This returns: AttributeError: 'int' object has no attribute 'add_label'

AuthenticationError                       Traceback (most recent call last)
<ipython-input-3-69ade5292074> in <module>()
----> 1 g.login ('**********', '**********')

/home/debdut/Code/workspace/gmail/gmail/gmail.pyc in login(self, username, password)
    104                 self.fetch_mailboxes()
    105         except imaplib.IMAP4.error:
--> 106             raise AuthenticationError
    107 
    108 

AuthenticationError: 

I also got an email that Google is blocking the login. How to fix it?
Note: I have replaced my username password with *'s.

I'm getting this error when trying to fetch any msg. I'm at commit 667c149 and using ubuntu. Looks like a bug. Hopefully Charlie can fix it soon.

unread[1].fetch()
Traceback (most recent call last):
File "", line 1, in
File "message.py", line 171, in fetch
self.parse(results[0])
File "message.py", line 164, in parse
self.attachments = [Attachment(attachment) for attachment in self.message._payload if attachment.get('Content-Disposition') is not None]
AttributeError: 'str' object has no attribute 'get'

Please add the expunge function to allow permanent removal of messages in the trash

Here is what is some of the output

['body', 'delivered_to', 'fr', 'uid', 'thread', 'thread_id', 'cc', 'labels', 'mailbox', 'to', 'flags', 'sent_at', 'message', 'subject', 'message_id', 'gmail']
[None, None, None, '161464', [], None, None, [], <gmail.mailbox.Mailbox instance at 0x1049179e0>, None, [], None, None, None, None, <gmail.gmail.Gmail instance at 0x1049173b0>]
<gmail.message.Message instance at 0x10492ee60>

Here is the code I am using... I dont think I am doing anything wrong. logged_in is returning true so it appears I am authenticated.

!/usr/bin/python

from gmail import Gmail
import datetime

g = Gmail()

g.login("noybusername","noybpassword")
emails = g.inbox().mail(fr="[email protected]")
print(g.logged_in)
print(emails[0].uid)
print(emails[0].fr)
for email in emails:
print(email.dict.keys())
print(email.dict.values())
print(email)

g.logout()

I am trying to retrieve read/unread status of mail using
emails[0].is_read.
It returns ">" for all emails whether its read or unread.

Also tried with emails[0].read. But it also returns ">".

Please help

unread = g.inbox().mail(unread=True)
print unread[0].body

This works once, but after that the email moves all the emails to All Mails from Inbox and the list becomes empty.

Gmail support "Search X-GM-RAW ..." command, which we can use
gmail.imap.uid('SEARCH', 'X-GM-RAW', .....) to fetch email;

but I need the result to be wrapped as the Message object.

Which means, separate the Mailbox.mail function into fetching part and wrapping part.

would be great if we could to just pip install.

Hello,
How is it possible to get the sender Info to a string in format Some Name <[email protected]>, the date it was sent and if there any other recipients (cc)? I tried the following but it din't worked:

inbox = g.inbox().mail(sender="[email protected]")
for msg in inbox:
                    msg.fetch()
                    print msg.body, msg.subject, msg.date, msg.cc

It seems that newest version is at https://github.com/girishramnani/gmail

Something like this

class Gmail:

    def __init__(self, username, password):
        self.username = username
        self.password = password

    def __enter__(self):
        # note: getpass might be better here, instead of keeping the pwd in memory
        self.g = gmail.login(self.username, self.password)
        return self.g

    def __exit__(self, *args, **kwds):
        try:
            print('logging out...')
            self.g.logout()
        except:
            raise

allows this

with Gmail(username, password) as conn:
    print('Reading all your emails from spam folder:')

    spam_box = conn.spam().mail(prefetch=True)
    n = conn.spam().count()

    for idx, email in enumerate(spam_box):
        print('fetching %d of %d...' % (idx + 1, n))

which would be nice to have implemented in the gmail package

I'm trying to fetch the body of an email using

mails = g.inbox().mail(sender="[email protected]")
mail = mails[0].fetch()
print mail['subject']
print mail.body

Here, I am able to get properties like subject, Received, etc. but when printing body, I get this error :

Message instance has no attribute 'body'

This is the data I'm getting :

From nobody Mon Dec 26 16:42:46 2016
Delivered-To: [email protected]
Received: by 10.28.211.66 with SMTP id ferf98er9fef9fr;
.
.
.
X-Source-Dir: erferfefefrref:/public_html
X-CMAE-Envelope: grtgrtgrtgrtgrt......

This is the message body

It may be much better to use GmailAPI than IMAP

If you want to use it, this library will help you: https://github.com/Charlkie/PyMail

Hi

I have a script that fetches my emails (more than 5000) and there is an issue with a specific email (maybe also with some others ?). Sorry I can only give you the error and not the content of the email because I don't know which one it is...

Traceback (most recent call last):
File "get_emails_gmail.py", line 54, in
mail.fetch()
File "build\bdist.win-amd64\egg\gmail\message.py", line 181, in fetch
self.parse(results[0])
File "build\bdist.win-amd64\egg\gmail\message.py", line 173, in parse
if not isinstance(attachment, basestring) and attachment.get('Content-Disposition') is not None
File "build\bdist.win-amd64\egg\gmail\message.py", line 223, in init
self.size = int(round(len(self.payload)/1000.0))
TypeError: object of type 'NoneType' has no len()

email.star()
email.read()
email.unstar()
.. all the other work
except email.spam()

AttributeError: Message instance has no attribute 'spam'

in gmail contacts, a person can have more than one email, some of my contacts have 3 emails, but they are the same person. How do I filter by all three of those email? I can link to gmail contacts to retrieve the 3 emails, but then what?

Or maybe can it be integrated with gmail contacts, so i can filter by a specific contact. That would be really useful.