Skip to main content
Glama
nylas-samples

Nylas API MCP Server

Official

Servidor MCP de la API de Nylas (experimental)

Nota : Este proyecto es experimental y su propósito es explorar el uso del Protocolo de Contexto de Modelo (MCP) como guía para la integración de la API de Nylas. No es oficial y debe usarse únicamente con fines de aprendizaje y experimentación.

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) para la API de Nylas. Proporciona recursos, herramientas y sugerencias para ayudar a los desarrolladores a comprender e integrar la API de Nylas para las funciones de correo electrónico, calendario y contactos.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar para integrar datos, herramientas e indicaciones con aplicaciones de IA. Los servidores MCP pueden exponer recursos, herramientas e indicaciones a aplicaciones de IA como Claude Desktop , Cursor y otras compatibles con MCP.

Related MCP server: NetlifyMCPServer

Características

Este servidor MCP proporciona:

  • Recursos de documentación : documentación completa sobre los puntos finales de la API de Nylas, la autenticación y las mejores prácticas

  • Ejemplos de código : ejemplos de código listos para usar para diversas operaciones de la API de Nylas en varios lenguajes (Node.js, Python, Java, Ruby, curl)

  • Herramientas interactivas : herramientas para generar código de autenticación y código de implementación específico del punto final

  • Avisos : Avisos prediseñados para escenarios comunes de integración de Nylas

Captura de pantalla del 16/03/2025 a las 16:43:38

Empezando

Prerrequisitos

  • Node.js 18+

  • npm

Instalación

  1. Clonar este repositorio

  2. Instalar dependencias

npm install
  1. Construir el proyecto

npm run build

Ejecución del servidor MCP

Uso de stdio (para integración directa con clientes MCP)

npm start

Uso de HTTP con SSE (para conexiones remotas)

MCP_MODE=http npm start

De forma predeterminada, el servidor HTTP se ejecuta en el puerto 3000. Puede cambiar esto configurando la variable de entorno PORT :

MCP_MODE=http PORT=8080 npm start

Uso con clientes MCP

Escritorio de Claude

  1. Inicie el servidor MCP en modo stdio

  2. En Claude Desktop, vaya a Configuración > Servidores

  3. Haga clic en "Agregar servidor"

  4. Seleccione "Ejecutar un comando local" e ingrese el comando para iniciar este servidor:

node /path/to/nylas-api-mcp/dist/index.js
  1. Dale un nombre (por ejemplo, "API de Nylas")

  2. Después de agregar, puedes usar todos los recursos, herramientas y mensajes de la API de Nylas en tus conversaciones de Claude

Cursor

  1. Inicie el servidor MCP en modo stdio

  2. En Cursor, agregue un nuevo servidor MCP en la configuración

  3. Configúrelo para utilizar el comando:

node /path/to/nylas-api-mcp/dist/index.js

Recursos

Este servidor MCP proporciona los siguientes recursos:

  • Documentación general : Descripción general de las capacidades de la API de Nylas

  • Guía de autenticación : Cómo autenticarse con la API de Nylas

  • Puntos finales de API : documentación para puntos finales de correo electrónico, calendario, contactos y webhook

  • Ejemplos de código : ejemplos de uso en varios lenguajes de programación

Herramientas

Herramientas interactivas para la generación de código:

  • generate-auth-code : genera un código de autenticación en su idioma preferido

  • generate-endpoint-code : genera código para puntos finales de API específicos

  • search-api-docs : Busque en la documentación de la API de Nylas

Indicaciones

Indicaciones predefinidas para escenarios comunes:

  • Introducción básica a la API de Nylas

  • Guía de autenticación : Comprensión del flujo de OAuth

  • Integración de correo electrónico, calendario y contactos : orientación específica para cada función

  • Escenarios de integración : orientación para casos de uso específicos (cliente de correo electrónico, reserva de calendario, etc.)

  • Ejemplos de SDK : código de ejemplo en varios idiomas

  • Guía de depuración : problemas comunes y soluciones

Contribuyendo

¡Agradecemos sus contribuciones! Puede:

  1. Agregue más ejemplos de código al directorio nylas-code-samples

  2. Mejorar los recursos de documentación

  3. Añadir soporte para lenguajes de programación adicionales

  4. Crear nuevas herramientas y avisos

Descargo de responsabilidad

Este es un proyecto experimental y Nylas no ofrece soporte oficial. La información y el código proporcionados a través de este servidor MCP deben utilizarse únicamente como recurso de aprendizaje. Consulte siempre la documentación oficial de Nylas para obtener la información más precisa y actualizada sobre la API de Nylas.

El código de muestra proporcionado es para fines educativos y puede requerir manejo de errores adicionales, consideraciones de seguridad y pruebas antes de ser utilizado en entornos de producción.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

3 tools
generate-auth-codeD
ParametersJSON Schema
NameRequiredDescriptionDefault
languageYes
clientIdNo
clientSecretNo
redirectUriNo
scopesNo

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate-endpoint-codeD
ParametersJSON Schema
NameRequiredDescriptionDefault
languageYes
endpointYes
methodNo
paramsNo

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search-api-docsD
ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes
categoryNo

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 3 tool updates
    • First observedgenerate-auth-code
    • First observedgenerate-endpoint-code
    • First observedsearch-api-docs

TDQS

D1.4/5.0
Disambiguation2/5

The tools have overlapping purposes that could cause confusion. 'generate-auth-code' and 'generate-endpoint-code' both involve code generation for different parts of the Nylas API, but without descriptions, their specific boundaries are unclear. 'search-api-docs' is more distinct but still part of the same API exploration domain.

Naming Consistency4/5

The naming follows a consistent verb-object pattern with hyphens (e.g., generate-auth-code, search-api-docs), which is predictable and readable. There are no deviations in style across the three tools, though the pattern is simple and lacks more sophisticated conventions.

Tool Count2/5

With only 3 tools, the server feels thin for an API-focused purpose like the Nylas API, which typically involves multiple operations such as CRUD for emails, calendars, or contacts. This limited set suggests significant gaps in coverage for the apparent domain.

Completeness1/5

The tool surface is severely incomplete for an API server. There are no tools for core API operations like sending emails, managing events, or accessing user data, which are essential for the Nylas API domain. The existing tools only cover authentication, endpoint code generation, and documentation search, leaving major gaps.

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    A simple demonstration project for the Model Control Protocol (MCP) server that provides tools for AI assistants to fetch news articles, perform calculations, retrieve weather data, and generate personalized greetings.
    3
    MIT
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A basic example of developing and running serverless Model Context Protocol (MCP) using Netlify Functions, enabling AI agents to interact with your services via a standardized API.
    -
  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol server that creates tools from API configurations defined in YAML files, allowing easy integration of external APIs into an MCP ecosystem without coding.
    7
    21
    7
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nylas-samples/nylas-api-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server