Nylas MCP by usefulapi
MCP server for Nylas — read email, calendars, events and contacts, and send email or create events.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"nylas": {
"url": "https://nylas.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://nylas.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거