Nylas MCP by usefulapi
MCP server for Nylas — read email, calendars, events and contacts, and send email or create events.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"nylas": {
"url": "https://nylas.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://nylas.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (15)
🟢nylas_list_grants(limit, offset)
List the connected accounts (grants) on this Nylas application, each with a grant_id used to scope other tools. Not grant-scoped. Nylas v3: GET /v3/grants.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Max grants to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"offset": {
"description": "Pagination offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_get_grant(grant_id)
Get details for a single connected account (grant). Nylas v3: GET /v3/grants/{grant_id}.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_list_messages(grant_id, limit, page_token, subject, from, ...)
List email messages for the connected account, with optional filters. Nylas v3: GET /v3/grants/{grant_id}/messages.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"limit": {
"description": "Max messages to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_token": {
"description": "Pagination cursor (next_cursor from a prior page).",
"type": "string"
},
"subject": {
"description": "Filter by subject.",
"type": "string"
},
"from": {
"description": "Filter by sender email address.",
"type": "string"
},
"to": {
"description": "Filter by recipient email address.",
"type": "string"
},
"unread": {
"description": "If set, filter by unread status.",
"type": "boolean"
},
"starred": {
"description": "If set, filter by starred status.",
"type": "boolean"
},
"in": {
"description": "Filter by folder id.",
"type": "string"
},
"search_query_native": {
"description": "Provider-native search query string.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_get_message(message_id, grant_id)
Get a single email message by id. Nylas v3: GET /v3/grants/{grant_id}/messages/{message_id}.
Esquema de entrada
{
"type": "object",
"properties": {
"message_id": {
"type": "string",
"description": "The message id to fetch."
},
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
}
},
"required": [
"message_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_list_folders(grant_id, limit)
List mail folders/labels for the connected account. Nylas v3: GET /v3/grants/{grant_id}/folders.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"limit": {
"description": "Max folders to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_list_calendars(grant_id, limit, page_token)
List calendars for the connected account (each has a calendar_id used by the events tools). Nylas v3: GET /v3/grants/{grant_id}/calendars.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"limit": {
"description": "Max calendars to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_token": {
"description": "Pagination cursor (next_cursor from a prior page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_get_calendar(calendar_id, grant_id)
Get a single calendar by id. Nylas v3: GET /v3/grants/{grant_id}/calendars/{calendar_id}.
Esquema de entrada
{
"type": "object",
"properties": {
"calendar_id": {
"type": "string",
"description": "The calendar id to fetch."
},
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
}
},
"required": [
"calendar_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_list_events(calendar_id, grant_id, limit, page_token, start, ...)
List calendar events. Requires calendar_id (sent as a query param). Nylas v3: GET /v3/grants/{grant_id}/events.
Esquema de entrada
{
"type": "object",
"properties": {
"calendar_id": {
"type": "string",
"description": "REQUIRED. The calendar id (sent as a query param)."
},
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"limit": {
"description": "Max events to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_token": {
"description": "Pagination cursor (next_cursor from a prior page).",
"type": "string"
},
"start": {
"description": "Filter: earliest event start, Unix timestamp (seconds).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"end": {
"description": "Filter: latest event start, Unix timestamp (seconds).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"show_cancelled": {
"description": "Include cancelled events.",
"type": "boolean"
}
},
"required": [
"calendar_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_get_event(event_id, calendar_id, grant_id)
Get a single calendar event by id. Requires calendar_id (sent as a query param). Nylas v3: GET /v3/grants/{grant_id}/events/{event_id}.
Esquema de entrada
{
"type": "object",
"properties": {
"event_id": {
"type": "string",
"description": "The event id to fetch."
},
"calendar_id": {
"type": "string",
"description": "REQUIRED. The calendar id (sent as a query param)."
},
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
}
},
"required": [
"event_id",
"calendar_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_list_contacts(grant_id, limit, page_token, email, phone_number)
List contacts for the connected account, with optional email/phone filters. Nylas v3: GET /v3/grants/{grant_id}/contacts.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"limit": {
"description": "Max contacts to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_token": {
"description": "Pagination cursor (next_cursor from a prior page).",
"type": "string"
},
"email": {
"description": "Filter by email address.",
"type": "string"
},
"phone_number": {
"description": "Filter by phone number.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_get_contact(contact_id, grant_id)
Get a single contact by id. Nylas v3: GET /v3/grants/{grant_id}/contacts/{contact_id}.
Esquema de entrada
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"description": "The contact id to fetch."
},
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nylas_list_drafts(grant_id, limit, page_token)
List draft emails for the connected account. Nylas v3: GET /v3/grants/{grant_id}/drafts.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"limit": {
"description": "Max drafts to return.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page_token": {
"description": "Pagination cursor (next_cursor from a prior page).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴nylas_send_message(grant_id, to, subject, body, cc, ...)
SENDS a real email via the connected account. This dispatches an actual message. Nylas v3: POST /v3/grants/{grant_id}/messages/send.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Recipient email addresses (array of strings)."
},
"subject": {
"description": "Email subject line.",
"type": "string"
},
"body": {
"description": "Email body (HTML or plain text).",
"type": "string"
},
"cc": {
"description": "CC email addresses (array of strings).",
"type": "array",
"items": {
"type": "string"
}
},
"bcc": {
"description": "BCC email addresses (array of strings).",
"type": "array",
"items": {
"type": "string"
}
},
"reply_to_message_id": {
"description": "Id of the message this is a reply to.",
"type": "string"
}
},
"required": [
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴nylas_create_event(calendar_id, grant_id, title, start_time, end_time, ...)
Creates a calendar event (may send invites to participants). Requires calendar_id (sent as a query param). Nylas v3: POST /v3/grants/{grant_id}/events.
Esquema de entrada
{
"type": "object",
"properties": {
"calendar_id": {
"type": "string",
"description": "REQUIRED. The calendar id to create the event in (sent as a query param)."
},
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"title": {
"type": "string",
"description": "Event title."
},
"start_time": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Event start, Unix timestamp (seconds)."
},
"end_time": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Event end, Unix timestamp (seconds)."
},
"description": {
"description": "Event description.",
"type": "string"
},
"location": {
"description": "Event location.",
"type": "string"
},
"participants": {
"description": "Participant email addresses (array of strings).",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"calendar_id",
"title",
"start_time",
"end_time"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴nylas_create_draft(grant_id, to, subject, body, cc, ...)
Creates a draft email (does NOT send — safe/additive). Nylas v3: POST /v3/grants/{grant_id}/drafts.
Esquema de entrada
{
"type": "object",
"properties": {
"grant_id": {
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call.",
"type": "string"
},
"to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Recipient email addresses (array of strings)."
},
"subject": {
"description": "Email subject line.",
"type": "string"
},
"body": {
"description": "Email body (HTML or plain text).",
"type": "string"
},
"cc": {
"description": "CC email addresses (array of strings).",
"type": "array",
"items": {
"type": "string"
}
},
"bcc": {
"description": "BCC email addresses (array of strings).",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia