Nylas MCP by usefulapi is an MCP server published by io.usefulapi, hosted at nylas.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 15 tools, including nylas_list_grants, nylas_get_grant, nylas_list_messages, nylas_get_message, nylas_list_folders.
MCP server for Nylas — read email, calendars, events and contacts, and send email or create events.
4,099 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max grants to return. |
| offset | integer | Pagination offset. |
{
"name": "nylas_list_grants",
"title": "List grants (connected accounts)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max grants to return.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset."
}
}
},
"annotations": {
"title": "List grants (connected accounts)",
"readOnlyHint": true
}
}Get details for a single connected account (grant). Nylas v3: GET /v3/grants/{grant_id}.
| Parameter | Type | Description |
|---|---|---|
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
{
"name": "nylas_get_grant",
"title": "Get a grant",
"description": "Get details for a single connected account (grant). Nylas v3: GET /v3/grants/{grant_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
}
}
},
"annotations": {
"title": "Get a grant",
"readOnlyHint": true
}
}List email messages for the connected account, with optional filters. Replies with full message bodies are large and get cut off: pass select (e.g. id,thread_id,subject,from,to,date,snippet,unread,folders) and a limit of about 20, then read single messages with nylas_get_message. Narrow by date with received_after / received_before rather than search_query_native: native search runs in the mail provider and can take over a minute on a large mailbox. For Google and Microsoft accounts, search_query_native can be combined only with in, limit and page_token (other filters return HTTP 400). Nylas v3: GET /v3/grants/{grant_id}/messages.
| Parameter | Type | Description |
|---|---|---|
| in | string | Filter by folder id. |
| to | string | Filter by recipient email address. |
| from | string | Filter by sender email address. |
| limit | integer | Max messages to return. |
| select | string | Comma-separated top-level fields to return, e.g. id,thread_id,subject,from,to,date,snippet,unread,folders. Keeps replies small. |
| unread | boolean | If set, filter by unread status. |
| starred | boolean | If set, filter by starred status. |
| subject | string | Filter by subject. |
| grant_id | string |
Get a single email message by id. Nylas v3: GET /v3/grants/{grant_id}/messages/{message_id}.
| Parameter | Type | Description |
|---|---|---|
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| message_id * | string | The message id to fetch. |
{
"name": "nylas_get_message",
"title": "Get a message",
"description": "Get a single email message by id. Nylas v3: GET /v3/grants/{grant_id}/messages/{message_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"message_id": {
"type": "string",
"description": "The message id to fetch."
}
}
},
"annotations": {
"title": "Get a message",
"readOnlyHint": true
}
}List mail folders/labels for the connected account. Nylas v3: GET /v3/grants/{grant_id}/folders.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max folders to return. |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
{
"name": "nylas_list_folders",
"title": "List folders",
"description": "List mail folders/labels for the connected account. Nylas v3: GET /v3/grants/{grant_id}/folders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max folders to return.",
"exclusiveMinimum": 0
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
}
}
},
"annotations": {
"title": "List folders",
"readOnlyHint": true
}
}List calendars for the connected account (each has a calendar_id used by the events tools). Nylas v3: GET /v3/grants/{grant_id}/calendars.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max calendars to return. |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| page_token | string | Pagination cursor (next_cursor from a prior page). |
{
"name": "nylas_list_calendars",
"title": "List calendars",
"description": "List calendars for the connected account (each has a calendar_id used by the events tools). Nylas v3: GET /v3/grants/{grant_id}/calendars.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max calendars to return.",
"exclusiveMinimum": 0
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"page_token": {
"type": "string",
"description": "Pagination cursor (next_cursor from a prior page)."
}
}
},
"annotations": {
"title": "List calendars",
"readOnlyHint": true
}
}Get a single calendar by id. Nylas v3: GET /v3/grants/{grant_id}/calendars/{calendar_id}.
| Parameter | Type | Description |
|---|---|---|
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| calendar_id * | string | The calendar id to fetch. |
{
"name": "nylas_get_calendar",
"title": "Get a calendar",
"description": "Get a single calendar by id. Nylas v3: GET /v3/grants/{grant_id}/calendars/{calendar_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"calendar_id"
],
"properties": {
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"calendar_id": {
"type": "string",
"description": "The calendar id to fetch."
}
}
},
"annotations": {
"title": "Get a calendar",
"readOnlyHint": true
}
}List calendar events. Requires calendar_id (sent as a query param). Nylas v3: GET /v3/grants/{grant_id}/events.
| Parameter | Type | Description |
|---|---|---|
| end | integer | Filter: latest event start, Unix timestamp (seconds). |
| limit | integer | Max events to return. |
| start | integer | Filter: earliest event start, Unix timestamp (seconds). |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| page_token | string | Pagination cursor (next_cursor from a prior page). |
| calendar_id * | string | REQUIRED. The calendar id (sent as a query param). |
| show_cancelled | boolean | Include cancelled events. |
{
"name": "nylas_list_events",
"title": "List events",
"description": "List calendar events. Requires calendar_id (sent as a query param). Nylas v3: GET /v3/grants/{grant_id}/events.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"calendar_id"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter: latest event start, Unix timestamp (seconds)."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max events to return.",
"exclusiveMinimum": 0
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter: earliest event start, Unix timestamp (seconds)."
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"page_token": {
"type": "string",
"description": "Pagination cursor (next_cursor from a prior page)."
},
"calendar_id": {
"type": "string",
"description": "REQUIRED. The calendar id (sent as a query param)."
},
"show_cancelled": {
"type": "boolean",
"description": "Include cancelled events."
}
}
},
"annotations": {
"title": "List events",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| event_id * | string | The event id to fetch. |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| calendar_id * | string | REQUIRED. The calendar id (sent as a query param). |
{
"name": "nylas_get_event",
"title": "Get an event",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"calendar_id"
],
"properties": {
"event_id": {
"type": "string",
"description": "The event id to fetch."
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"calendar_id": {
"type": "string",
"description": "REQUIRED. The calendar id (sent as a query param)."
}
}
},
"annotations": {
"title": "Get an event",
"readOnlyHint": true
}
}List contacts for the connected account, with optional email/phone filters. Nylas v3: GET /v3/grants/{grant_id}/contacts.
| Parameter | Type | Description |
|---|---|---|
| string | Filter by email address. | |
| limit | integer | Max contacts to return. |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| page_token | string | Pagination cursor (next_cursor from a prior page). |
| phone_number | string | Filter by phone number. |
{
"name": "nylas_list_contacts",
"title": "List contacts",
"description": "List contacts for the connected account, with optional email/phone filters. Nylas v3: GET /v3/grants/{grant_id}/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"description": "Filter by email address."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max contacts to return.",
"exclusiveMinimum": 0
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"page_token": {
"type": "string",
"description": "Pagination cursor (next_cursor from a prior page)."
},
"phone_number": {
"type": "string",
"description": "Filter by phone number."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}Get a single contact by id. Nylas v3: GET /v3/grants/{grant_id}/contacts/{contact_id}.
| Parameter | Type | Description |
|---|---|---|
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| contact_id * | string | The contact id to fetch. |
{
"name": "nylas_get_contact",
"title": "Get a contact",
"description": "Get a single contact by id. Nylas v3: GET /v3/grants/{grant_id}/contacts/{contact_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"contact_id": {
"type": "string",
"description": "The contact id to fetch."
}
}
},
"annotations": {
"title": "Get a contact",
"readOnlyHint": true
}
}List draft emails for the connected account. Nylas v3: GET /v3/grants/{grant_id}/drafts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max drafts to return. |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| page_token | string | Pagination cursor (next_cursor from a prior page). |
{
"name": "nylas_list_drafts",
"title": "List drafts",
"description": "List draft emails for the connected account. Nylas v3: GET /v3/grants/{grant_id}/drafts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max drafts to return.",
"exclusiveMinimum": 0
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"page_token": {
"type": "string",
"description": "Pagination cursor (next_cursor from a prior page)."
}
}
},
"annotations": {
"title": "List drafts",
"readOnlyHint": true
}
}SENDS a real email via the connected account. This dispatches an actual message. Nylas v3: POST /v3/grants/{grant_id}/messages/send.
| Parameter | Type | Description |
|---|---|---|
| cc | array | CC email addresses (array of strings). |
| to * | array | Recipient email addresses (array of strings). |
| bcc | array | BCC email addresses (array of strings). |
| body | string | Email body (HTML or plain text). |
| subject | string | Email subject line. |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| reply_to_message_id | string | Id of the message this is a reply to. |
{
"name": "nylas_send_message",
"title": "Send an email",
"description": "SENDS a real email via the connected account. This dispatches an actual message. Nylas v3: POST /v3/grants/{grant_id}/messages/send.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to"
],
"properties": {
"cc": {
"type": "array",
"items": {
"type": "string"
},
"description": "CC email addresses (array of strings)."
},
"to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Recipient email addresses (array of strings)."
},
"bcc": {
"type": "array",
"items": {
"type": "string"
},
"description": "BCC email addresses (array of strings)."
},
"body": {
"type": "string",
"description": "Email body (HTML or plain text)."
},
"subject": {
"type": "string",
"description": "Email subject line."
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"reply_to_message_id": {
"type": "string",
"description": "Id of the message this is a reply to."
}
}
},
"annotations": {
"title": "Send an email",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Event title. |
| end_time * | integer | Event end, Unix timestamp (seconds). |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| location | string | Event location. |
| start_time * | integer | Event start, Unix timestamp (seconds). |
| calendar_id * | string | REQUIRED. The calendar id to create the event in (sent as a query param). |
| description | string | Event description. |
| participants | array | Participant email addresses (array of strings). |
Creates a draft email (does NOT send — safe/additive). Nylas v3: POST /v3/grants/{grant_id}/drafts.
| Parameter | Type | Description |
|---|---|---|
| cc | array | CC email addresses (array of strings). |
| to * | array | Recipient email addresses (array of strings). |
| bcc | array | BCC email addresses (array of strings). |
| body | string | Email body (HTML or plain text). |
| subject | string | Email subject line. |
| grant_id | string | Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
{
"name": "nylas_create_draft",
"title": "Create a draft email",
"description": "Creates a draft email (does NOT send — safe/additive). Nylas v3: POST /v3/grants/{grant_id}/drafts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"to"
],
"properties": {
"cc": {
"type": "array",
"items": {
"type": "string"
},
"description": "CC email addresses (array of strings)."
},
"to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Recipient email addresses (array of strings)."
},
"bcc": {
"type": "array",
"items": {
"type": "string"
},
"description": "BCC email addresses (array of strings)."
},
"body": {
"type": "string",
"description": "Email body (HTML or plain text)."
},
"subject": {
"type": "string",
"description": "Email subject line."
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
}
}
},
"annotations": {
"title": "Create a draft email",
"destructiveHint": true
}
}Tools for Nylas, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show me the emails that I received in my inbox today."; "What meetings do I have on my calendar this week?"; "Show the latest emails from jane@acme.example and summarize what she wants.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Nylas data. Free plan: 50 tool calls per month. Run nylas_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run nylas_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run nylas_upgrade without a plan: it returns both plans, each with a payment link for the user to open. nylas_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Connected-account grant id. Overrides NYLAS_GRANT_ID for this call. |
| any_email | string | Comma-separated email addresses (up to 25); matches To, From, CC or BCC. |
| page_token | string | Pagination cursor (next_cursor from a prior page). |
| has_attachment | boolean | If true, only messages with attachments. |
| received_after | integer | Only messages received after this time, in Unix seconds (e.g. 1763769600 = 2025-11-22T00:00:00Z). |
| received_before | integer | Only messages received before this time, in Unix seconds. |
| search_query_native | string | Provider-native search query (Gmail operators, Microsoft KQL, or IMAP SEARCH). Google and Microsoft: combine only with in, limit and page_token. Can be slow on large mailboxes. |
{
"name": "nylas_list_messages",
"title": "List messages",
"description": "List email messages for the connected account, with optional filters. Replies with full message bodies are large and get cut off: pass select (e.g. id,thread_id,subject,from,to,date,snippet,unread,folders) and a limit of about 20, then read single messages with nylas_get_message. Narrow by date with received_after / received_before rather than search_query_native: native search runs in the mail provider and can take over a minute on a large mailbox. For Google and Microsoft accounts, search_query_native can be combined only with in, limit and page_token (other filters return HTTP 400). Nylas v3: GET /v3/grants/{grant_id}/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"in": {
"type": "string",
"description": "Filter by folder id."
},
"to": {
"type": "string",
"description": "Filter by recipient email address."
},
"from": {
"type": "string",
"description": "Filter by sender email address."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Max messages to return.",
"exclusiveMinimum": 0
},
"select": {
"type": "string",
"pattern": "^[a-z_]+(,[a-z_]+)*$",
"description": "Comma-separated top-level fields to return, e.g. id,thread_id,subject,from,to,date,snippet,unread,folders. Keeps replies small."
},
"unread": {
"type": "boolean",
"description": "If set, filter by unread status."
},
"starred": {
"type": "boolean",
"description": "If set, filter by starred status."
},
"subject": {
"type": "string",
"description": "Filter by subject."
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"any_email": {
"type": "string",
"description": "Comma-separated email addresses (up to 25); matches To, From, CC or BCC."
},
"page_token": {
"type": "string",
"description": "Pagination cursor (next_cursor from a prior page)."
},
"has_attachment": {
"type": "boolean",
"description": "If true, only messages with attachments."
},
"received_after": {
"type": "integer",
"maximum": 9999999999,
"minimum": 0,
"description": "Only messages received after this time, in Unix seconds (e.g. 1763769600 = 2025-11-22T00:00:00Z)."
},
"received_before": {
"type": "integer",
"maximum": 9999999999,
"minimum": 0,
"description": "Only messages received before this time, in Unix seconds."
},
"search_query_native": {
"type": "string",
"description": "Provider-native search query (Gmail operators, Microsoft KQL, or IMAP SEARCH). Google and Microsoft: combine only with in, limit and page_token. Can be slow on large mailboxes."
}
}
},
"annotations": {
"title": "List messages",
"readOnlyHint": true
}
}{
"name": "nylas_create_event",
"title": "Create a calendar event",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"calendar_id",
"title",
"start_time",
"end_time"
],
"properties": {
"title": {
"type": "string",
"description": "Event title."
},
"end_time": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Event end, Unix timestamp (seconds)."
},
"grant_id": {
"type": "string",
"description": "Connected-account grant id. Overrides NYLAS_GRANT_ID for this call."
},
"location": {
"type": "string",
"description": "Event location."
},
"start_time": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Event start, Unix timestamp (seconds)."
},
"calendar_id": {
"type": "string",
"description": "REQUIRED. The calendar id to create the event in (sent as a query param)."
},
"description": {
"type": "string",
"description": "Event description."
},
"participants": {
"type": "array",
"items": {
"type": "string"
},
"description": "Participant email addresses (array of strings)."
}
}
},
"annotations": {
"title": "Create a calendar event",
"destructiveHint": true
}
}