How to send email in PhoneGap (Android) using a gmail account


For the last one month, I have been working on an android app for a grocery store.
I have been using PhoneGap to develop the solution as the client wanted both Android and Iphone version.
I have tried building the app in native Android but going through the hassle of designing css was just too much for me and plus I did not had time to learn Iphone development.

There was a short learning phase for PhoneGap and the results were awesome. However there was one area where I spent hours and ran into several issues. The customer wanted a Feedback section where the user could fill in feedback in a TextArea and hits Submit, which would send an email to customer in the background.

Now PhoneGap has plugin called WebIntent which will open a Email composer where you have to hit Send. This is not what I wanted as customer would have to hit a SUBMIT button, which would open a Email composer window on Phone and then hit Send again. Also this solution also meant user’s email address would be displayed to Grocery store.
I wanted to send the feedback in the background anonymously to Grocery store. I decided to use Java email Api and create a dummy email for grocery store which would be used to send feedback to the Grocery store’s main email address.

I did not find any good tutorial except this one. This is an incomplete tutorial and did not tell you how to create Java classes for Plugin or that you had to make entries in config.xml. So here is the actual tutorial.

Before I begin, let me tell you that I am using latest version of Cordova 2.1.0. This is will not work for Cordova 1.9.0(I will explain the issue below).

Step 1: Add cordova-2.1.0.jar in the project classpath

Step 2: Add cordova-2.1.0.js in the assets/www/js folder.

Step 3: create a new Java class called

package com.dinesh.pb;
import org.apache.cordova.api.Plugin;
import org.apache.cordova.api.PluginResult;
import org.apache.cordova.api.PluginResult.Status;
import org.json.JSONArray;
import org.json.JSONException;
import android.annotation.SuppressLint;
import android.content.Intent;
import android.text.Html;
import com.dinesh.pb.utility.Mail;
public class EmailComposer extends Plugin {
public final String ACTION_SEND_EMAIL = "sendEmail";

 public PluginResult execute(String action, JSONArray arg1, String callbackId) {
 PluginResult result = new PluginResult(Status.INVALID_ACTION);
 if (action.equals(ACTION_SEND_EMAIL)) {
 try {
 String message = arg1.getString(0);
 result = new PluginResult(Status.OK);

 catch (JSONException ex) {
 result = new PluginResult(Status.JSON_EXCEPTION, ex.getMessage());
 } catch (Exception e) {
 // TODO Auto-generated catch block
 return result;

 private void sendEmailViaGmail(String body) throws Exception{
 Mail m = new Mail("[email protected]", "your password");
 String[] toArr = {"[email protected]"};
 m.set_from("[email protected]");
 m.set_subject("TEST SUBJECT");
 boolean sendFlag = m.send();



Step 4. copy this in package of your choice. My package name is com.dinesh.pb.utility.

package com.dinesh.pb.utility;
import java.util.Date;
import java.util.Properties;
import javax.activation.CommandMap;
import javax.activation.DataHandler;
import javax.activation.DataSource;
import javax.activation.FileDataSource;
import javax.activation.MailcapCommandMap;
import javax.mail.BodyPart;
import javax.mail.Multipart;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
public class Mail extends javax.mail.Authenticator { 
 private String _user; 
 private String _pass; 

 private String[] _to; 
 private String _from; 

 private String _port; 
 private String _sport; 

 private String _host; 

 private String _subject; 
 private String _body; 

 private boolean _auth; 

 private boolean _debuggable; 

 private Multipart _multipart; 

 public Mail() { 
 _host = ""; // default smtp server 
 _port = "465"; // default smtp port 
 _sport = "465"; // default socketfactory port 

 _user = ""; // username 
 _pass = ""; // password 
 _from = ""; // email sent from 
 _subject = ""; // email subject 
 _body = ""; // email body 

 _debuggable = false; // debug mode on or off - default off 
 _auth = true; // smtp authentication - default on 

 _multipart = new MimeMultipart(); 

 // There is something wrong with MailCap, javamail can not find a handler for the multipart/mixed part, so this bit needs to be added. 
 MailcapCommandMap mc = (MailcapCommandMap) CommandMap.getDefaultCommandMap(); 
 mc.addMailcap("text/html;; x-java-content-handler=com.sun.mail.handlers.text_html"); 
 mc.addMailcap("text/xml;; x-java-content-handler=com.sun.mail.handlers.text_xml"); 
 mc.addMailcap("text/plain;; x-java-content-handler=com.sun.mail.handlers.text_plain"); 
 mc.addMailcap("multipart/*;; x-java-content-handler=com.sun.mail.handlers.multipart_mixed"); 
 mc.addMailcap("message/rfc822;; x-java-content-handler=com.sun.mail.handlers.message_rfc822"); 

 public Mail(String user, String pass) { 

 _user = user; 
 _pass = pass; 

 public boolean send() throws Exception { 
 Properties props = _setProperties(); 

 if(!_user.equals("") && !_pass.equals("") && _to.length > 0 && !_from.equals("") && !_subject.equals("") && !_body.equals("")) { 
 Session session = Session.getInstance(props, this); 

 MimeMessage msg = new MimeMessage(session); 

 msg.setFrom(new InternetAddress(_from)); 

 InternetAddress[] addressTo = new InternetAddress[_to.length]; 
 for (int i = 0; i < _to.length; i++) { 
 addressTo[i] = new InternetAddress(_to[i]); 
 msg.setRecipients(MimeMessage.RecipientType.TO, addressTo); 

 msg.setSentDate(new Date()); 

 // setup message body 
 BodyPart messageBodyPart = new MimeBodyPart(); 

 // Put parts in message 

 // send email 

 return true; 
 } else { 
 return false; 

 public void addAttachment(String filename) throws Exception { 
 BodyPart messageBodyPart = new MimeBodyPart(); 
 DataSource source = new FileDataSource(filename); 
 messageBodyPart.setDataHandler(new DataHandler(source)); 


 public String[] get_to() {
 return _to;
public void set_to(String[] _to) {
 this._to = _to;
public String get_from() {
 return _from;
public void set_from(String _from) {
 this._from = _from;
public String get_body() {
 return _body;
public void set_body(String _body) {
 this._body = _body;
 public PasswordAuthentication getPasswordAuthentication() { 
 return new PasswordAuthentication(_user, _pass); 

 private Properties _setProperties() { 
 Properties props = new Properties(); 

 props.put("", _host); 

 if(_debuggable) { 
 props.put("mail.debug", "true"); 

 if(_auth) { 
 props.put("mail.smtp.auth", "true"); 

 props.put("mail.smtp.port", _port); 
 props.put("mail.smtp.socketFactory.port", _sport); 
 props.put("mail.smtp.socketFactory.class", ""); 
 props.put("mail.smtp.socketFactory.fallback", "false"); 

 return props; 
public String get_subject() {
 return _subject;
public void set_subject(String _subject) {
 this._subject = _subject;

 // more of the getters and setters ….. 

Step 5: Update the config.xml and add the details about the new plugin class
Mine looks like this – <plugin name=”EmailComposer” value=”com.dinesh.pb.EmailComposer”/>. Please update the package name value=”com.dinesh.pb.EmailComposer” with your package path.

<?xml version="1.0" encoding="utf-8"?> 
    <access origin="*"/> <!-- allow local pages --> 
    <access origin=".*"/> 
    <log level="DEBUG"/>
    <preference name="useBrowserHistory" value="false" />
    <preference name="exit-on-suspend" value="false" />
    <plugin name="App" value="org.apache.cordova.App"/>
    <plugin name="Geolocation" value="org.apache.cordova.GeoBroker"/>
    <plugin name="Device" value="org.apache.cordova.Device"/>
    <plugin name="Accelerometer" value="org.apache.cordova.AccelListener"/>
    <plugin name="Compass" value="org.apache.cordova.CompassListener"/>
    <plugin name="Media" value="org.apache.cordova.AudioHandler"/>
    <plugin name="Camera" value="org.apache.cordova.CameraLauncher"/>
    <plugin name="Contacts" value="org.apache.cordova.ContactManager"/>
    <plugin name="File" value="org.apache.cordova.FileUtils"/>
    <plugin name="NetworkStatus" value="org.apache.cordova.NetworkManager"/>
    <plugin name="Notification" value="org.apache.cordova.Notification"/>
    <plugin name="Storage" value="org.apache.cordova.Storage"/>
    <plugin name="Temperature" value="org.apache.cordova.TempListener"/>
    <plugin name="FileTransfer" value="org.apache.cordova.FileTransfer"/>
    <plugin name="Capture" value="org.apache.cordova.Capture"/>
    <plugin name="Battery" value="org.apache.cordova.BatteryListener"/>
    <plugin name="SplashScreen" value="org.apache.cordova.SplashScreen"/>
    <plugin name="Echo" value="org.apache.cordova.Echo" />
    <plugin name="EmailComposer" value="com.dinesh.pb.EmailComposer"/>

Step 6: Create a new javascript file called email.js

var EmailComposer = function(){};
cordova.addConstructor(function() {
    cordova.addPlugin("emailcomposer", new EmailComposer());
EmailComposer.prototype.send = function (message){
console.log("Calling the send message");
cordova.exec(function(){ alert('feedback sent')}, 
    function(){ alert('feedback was not sent')}, 
function sendFeedback(){
    window.EmailComposer.prototype.send("My message body");

Now as I mentioned earlier that I am using cordova-2.1.0.js/jar file there are subtle differences between the latest version and older version (cordova-1.9.0).  If you are using older version you will need to uncomment the section cordova.addConstructorabove and instead of calling

window.EmailComposer.prototype.send("My message body");
Use this:


If you do not use it then you may get error which would say that window.plugins is not defined. If you run into such issues use firebug and see what variables are defined under “window” variable.

Notice the method called “feedback()”. I am simply passing the user text as message body by capturing the input from user feedback TextBox. For simplicity I have just pasted a default Email body.

Step 7: Include the js file in your index.html file

// <!–[CDATA[
javascript” src=”js/email.js”>
// ]]>

Step 8: Include cordova js file in index.html

// <!–[CDATA[
javascript” src=”js/cordova-2.1.0.js”>
// ]]>

Step 9: Add three jar files for Java mail api – namely, Activation.jar, Mail.jar and Additional.jar in the libs folder and add it to the classpath. You can these files here.


UPDATE: A lot of people commented that they could not find mail.jar,additional.jar and actication.jar so I have uploaded them on You can download them from the link below.




  • How do you create a simple html form for the email to send with this tutorial? I am kinda a noob to javascript still lol.

    • Use dwr to submit the message and send the message to the Java method.

      • shivani

        can you please give an example for the same??
        just show an how to incorporate this code in an html file…
        please! its really urgent!

  • amit

    how to add “To field” dynamically in “window.EmailComposer.prototype.send(“My message body”);” like if i want “window.EmailComposer.prototype.send(“To”, “My message body”);”

    • You can collect the to field via input param and pass it emailcomposer

      • anand

        can u please give an example how to send mail using html code by doing all above process

        • Dinesh

          It’s already there in the post.

  • tomjm

    I could not find the Additional.jar file but i managed the rest of your instructions and tested it. I keep getting the alert: feedback was not sent. This means that startActivity() is failing. Does any1 know why this could be?

    • tomjm

      Sorry i meant “cordova.exec()” not “startActivity()”

      • tomjm

        In the log i am getting: Could not find class ‘javax.activation.DataHandler’, referenced from method com.dinesh.pb.utility.Mail.addAttachment

    • tomjm

      Now i am not getting any errors in the log but the alert keeps coming up: feedback was not sent

      • See my updated post and download the jar file.

  • Abdulqadir

    Can you please modify this plugin for Cordova-2.2.js latest phonegap version?

  • How do you send the e-mail as html?

  • seedorf

    I need someone to walk me through the process step by step because i am getting errors like “Create CommandMap’ in package ‘java.activation’

  • jyothi

    Hi, I am using cordova2.1.0 and have done every thing you have told . I get “Result of expression’window.EmailComposer'[Undefined] is not an object” … not able to figure out

    • Please update the plugin to use newer version. That should solve your problem.

  • This was very very helpful ! I liked the way you explain everything.
    For those who are using this, if you are using the latest version of phonegap – cordova 2.7.0 right now, please make sure you change the file to the latest execute method.
    Here is my java file (just in case you cannot figure out) –

    package com.example.phonegap;

    import org.apache.cordova.api.CallbackContext;
    import org.apache.cordova.api.CordovaPlugin;
    import org.json.JSONArray;
    import org.json.JSONException;

    import android.annotation.SuppressLint;

    public class EmailComposer extends CordovaPlugin {
    public final String ACTION_SEND_EMAIL = “sendEmail”;
    // CHECK THIS :
    public boolean execute(String action, JSONArray arg1, CallbackContext callbackContext) {
    //PluginResult result = new PluginResult(Status.INVALID_ACTION);
    if (action.equals(ACTION_SEND_EMAIL)) {
    try {
    String message = arg1.getString(0);
    return true;
    catch (JSONException ex) {
    return false;
    } catch (Exception e) {
    // TODO Auto-generated catch block
    return false;

    private void sendEmailViaGmail(String body) throws Exception{
    Mail m = new Mail(“[email protected]”, “password”);
    String[] toArr = {“[email protected]”};
    m.set_from(“[email protected]”);
    boolean sendFlag = m.send();



    • Karthikeyan Subramani

      Is this code working for you.. i am getting following error “The Jar of this class file belongs to container ‘android dependencies’ which does not allow modification to the source attachments in its entries”.

      • Yes it is working for me. Please update to latest cordova version. See Nikhil’s code in the comment which shows you how to make changes for latest cordova version.

    • Thank you for posting the updated the code. The version of cordova that I used is quite outdated now and your code should help others who are using the latest version.

  • I found a way on how to make this send HTML emails. Anyone looking for a solution of the same problem please follow the guide below:

    You can make this send HTML content by replacing this bit of the ‘send()’ method in file:

    // setup message body
    BodyPart messageBodyPart = new MimeBodyPart();


    // setup message body
    BodyPart messageBodyPart = new MimeBodyPart();
    messageBodyPart.setContent(_body, “text/html”);

  • Animesh Pradhan

    How do i set TO , FROM , SUBJECT and BODY from User Input as because I have already set it in the .

  • Alan Hoffmann-Hansen

    I keep getting error :Could not find class ‘’, referenced from method and Uncaught Error: Error calling method on NPObject. at file:///android_asset/www/cordova??

  • How can I block specific messages on android?

  • Thanks for sharing

  • Fernando

    I need the exact same thing but for IOS,
    Did you solve the problem for IOS ?

    • Dinesh

      Phonegap is platform agnostic. What works in Android would also work in IOS.