mcp-gmailcal 0.10.0

A MCP server for google mail, calendar, and contacts.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

pub mod auth;
pub mod config;
pub mod token_cache;
// ===== Module Declarations =====

/**
 * Gmail MCP Server Implementation
 *
 * This crate provides an MCP (Model Completion Protocol) server for Gmail,
 * allowing Claude to read emails from a Gmail account, search for contacts,
 * and manage calendar events.
 *
 * # Features
 *
 * - List emails from inbox
 * - Search emails using Gmail search queries
 * - Get details for a specific email
 * - List email labels
 * - Search for contacts
 * - List calendar events
 * - Create calendar events
 * - Check connection status
 *
 * # Testing
 *
 * The crate includes unit tests for internal functions and integration tests
 * for testing the MCP commands. Future improvements could include more
 * sophisticated mocking of the API endpoints and more comprehensive tests.
 */
// Core functionality
pub mod errors;
pub mod logging;
pub mod utils;

// API clients
pub mod calendar_api;
pub mod gmail_api;
pub mod people_api;

// Server implementation
pub mod cli;
pub mod oauth;
pub mod prompts;
pub mod server;

// ===== Re-exports =====

// Error handling and results
pub use crate::errors::{
    error_codes, CalendarApiError, CalendarResult, ConfigError, GmailApiError, GmailResult,
    PeopleApiError, PeopleResult,
};

// Configuration and constants
pub use crate::config::{get_token_expiry_seconds, Config, GMAIL_API_BASE_URL, OAUTH_TOKEN_URL};

// Logging setup
pub use crate::logging::setup_logging;

// Authentication
pub use crate::auth::TokenManager;
pub use crate::token_cache::{TokenCache, TokenCacheConfig, CachedToken};

// Gmail API types
pub use crate::gmail_api::{DraftEmail, EmailMessage, GmailService};

// People API types
pub use crate::people_api::{
    Contact, ContactList, EmailAddress, Organization, PeopleClient, PersonName, PhoneNumber, Photo,
};

// Calendar API types
pub use crate::calendar_api::{
    Attendee, CalendarClient, CalendarEvent, CalendarInfo, CalendarList, ConferenceData,
    ConferenceSolution, EntryPoint, EventOrganizer,
};

// Utils and prompts
pub use crate::prompts::*;
pub use crate::utils::{
    decode_base64, encode_base64_url_safe, error_codes as utils_error_codes, map_gmail_error,
    parse_max_results, to_mcp_error,
};

// Server implementation
pub use crate::server::GmailServer;