airtable-mcp-server

This repository hosts an Airtable Model Context Protocol (MCP) server, designed to grant Large Language Models (LLMs) the ability to interact with Airtable databases. It allows LLMs to inspect schemas, read, and write records.

Usage

To integrate with the Claude Desktop app, configure the claude_desktop_config.json file with the provided JSON snippet, ensuring to replace the placeholder with your Airtable personal access token, which requires schema.bases:read and data.records:read permissions.

Components

Tools

The server exposes a suite of tools: list_records, search_records, list_bases, list_tables, describe_table, get_record, create_record, update_records, delete_records, create_table, update_table, create_field, and update_field. Each tool offers specific functionalities like listing, searching, creating, updating, and deleting records, tables, and fields within Airtable.

Resources

The server provides schema information for Airtable bases and tables via airtable://<baseId>/<tableId>/schema, including base/table IDs, names, descriptions, field definitions, and view definitions.

Contributing

Contributions are welcome. Instructions are provided for setting up the development environment, running tests, and building the project.

Releases

The project follows semantic versioning. The release process involves bumping the version using npm version, pushing tags, and waiting for GitHub Actions to publish to NPM.