Working with GMail

From KDE UserBase Wiki


These instructions are only valid for kdepim and Korganizer version 4.3.7 and later. There are significant differences in the older versions, therefore, some instructions may not apply.


For demonstration purposes, the Google account used in this tutorial is [email protected]


This tutorial will allow you to setup IMAP forwarding from a Gmail account to KMail, which can be accessible through Kontact.

Incoming Mail Forwarding (IMAP Connection)

Firstly, you need to open Kontact. You can access it by simply typing its name in the search bar. Now, after Kontact starts up, click on Mail in the left vertical navigation bar. This brings you to the KMail part of Kontact. To set up the forwarding options, go to: Settings -> Configure KMail.

The first step is to create a basic identify, this is to separate multiple accounts in the future, if you have them.

Setting up a new Kmail identity.
Configuring the new identity.

Next, go to the Accounts tab on the left navigation bar. Here you can configure the incoming and outgoing mail accounts.

The Incoming/Outgoing Accounts Screen.

Setting up Incoming Mail:

Click on Add, and then ensure that “IMAP E-Mail Server” is highlighted, and then click OK. After this, 2 prompts will come up offering integration with the KDE Wallet service. For convenience, select the option entitled Allow Always.

Adding the new IMAP account.
Configuring KDE Wallet.

Now it is time to configure the incoming connection. Name your account Name whatever you want. Now, enter as the IMAP server Your Username is your email account, in this case mine is [email protected]. The Password is the password of your Gmail account.

Next, go to the Advanced tab, and ensure that it is connected on Port 993 with the SSL/TLS radio button left on. As for authentication, according to the KMail documentation, DIGEST-MD5 encryption is recommended, however for now Google’s IMAP server does not support any of this, so cleartext must be selected.

Click OK. Another KDE Wallet prompt should show up, and for convenience, you can select the Allow Always option.

To check your emails, find the Inbox of your newly setup account, in this case, Gmail Incoming, and press F5 to refresh and download new emails from the server.

Outgoing Mail Setup (SMTP Connection)

To setup an outgoing connection, similar steps must be taken to add the new connection, which is treated as a new account by KMail. Open up the KMail Configuration window, and go to the Accounts area in the left navigation bar. Instead of using the Receiving tab, which was used to setup the incoming (IMAP) connection switch to the Sending tab now.

Now, click on Add... and select the SMTP option and click OK. Afterwards, a Configure Account window will appear. The following details are needed by Kontact.

Outgoing mail server (Check the Server requires authentication button)
Login Your Gmail account. Here. it's "[email protected]"
Password Your Gmail password.

For convenience, check the Store SMTP password option. Now, go to the Advanced tab of the window and enter the following information.

Encryption SSL
Port: 465
Authentication PLAIN

After OKing the dialog, click the Set as Default button to make the newly added connection the default.

When sending your first email from Kontact, you will need to save the information in KDE Wallet once so it won’t have to be used later.

GIF Animation


Click the image below to watch the GIF Animation which displays this process in sequence for convenience

Congratulations, now you can fully send and receive mail through Kontact!