{"id":26648540,"url":"https://github.com/felores/airtable-mcp","last_synced_at":"2026-08-27T15:44:28.698Z","repository":{"id":268404148,"uuid":"904238387","full_name":"felores/airtable-mcp","owner":"felores","description":"Search, create and update Airtable bases, tables, fields, and records using Claude Desktop and MCP (Model Context Protocol) clients","archived":false,"fork":false,"pushed_at":"2025-01-27T16:44:10.000Z","size":127,"stargazers_count":69,"open_issues_count":2,"forks_count":35,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-26T08:48:06.845Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/felores.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-16T14:04:34.000Z","updated_at":"2025-12-05T07:06:25.000Z","dependencies_parsed_at":"2025-12-24T20:01:49.062Z","dependency_job_id":null,"html_url":"https://github.com/felores/airtable-mcp","commit_stats":null,"previous_names":["felores/airtable-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/felores/airtable-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felores%2Fairtable-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felores%2Fairtable-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felores%2Fairtable-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felores%2Fairtable-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felores","download_url":"https://codeload.github.com/felores/airtable-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felores%2Fairtable-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36944061,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-22T15:14:58.755Z","status":"online","status_checked_at":"2026-08-27T02:00:07.166Z","response_time":96,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-25T00:02:05.024Z","updated_at":"2026-08-27T15:44:28.428Z","avatar_url":"https://github.com/felores.png","language":"JavaScript","funding_links":[],"categories":["Databases","📚 Projects (1974 total)","Community Servers","Other Tools and Integrations","Cloud Services","Mcp Server Directories \u0026 Lists","🌐 Web Development","Table of Contents","🗂️ Extensions by Category","Other (143 servers)"],"sub_categories":["Spreadsheets \u0026 No-Code","MCP Servers","Databases","🗄️ Databases"],"readme":"# Airtable MCP Server\n\nA Model Context Protocol server that provides tools for interacting with Airtable's API. This server enables programmatic management of Airtable bases, tables, fields, and records through Claude Desktop or other MCP clients.\n\nThis MCP server features a specialized implementation that allows it to build tables in stages, leveraging Claude's agentic capabilities and minimizing the failure rate typically seen in other MCP servers for Airtable when building complex tables. It also includes [system prompt](https://github.com/felores/airtable-mcp/blob/main/prompts/system-prompt.md) and [project knowledge](https://github.com/felores/airtable-mcp/blob/main/prompts/project-knowledge.md) markdown files to provide additional guidance for the LLM when leveraging projects in Claude Desktop.\n\n## Requirements: Node.js\n\n1. Install Node.js (version 18 or higher) and npm from [nodejs.org](https://nodejs.org/)\n2. Verify installation:\n   ```bash\n   node --version\n   npm --version\n   ```\n\n⚠️ **Important**: Before running, make sure to setup your Airtable API key\n\n## Obtaining an Airtable API Key\n\n1. Log in to your Airtable account at [airtable.com](https://airtable.com)\n2. Create a personal access token at [Airtable's Builder Hub](https://airtable.com/create/tokens)\n3. In the Personal access token section select these scopes: \n     - data.records:read\n     - data.records:write\n     - schema.bases:read\n     - schema.bases:write\n4. Select the workspace or bases you want to give access to the personal access token\n5. Keep this key secure - you'll need it for configuration\n\n## Installation\n\n### Method 1: Using npx (Recommended)\n1. Navigate to the Claude configuration directory:\n\n   - Windows: `C:\\Users\\NAME\\AppData\\Roaming\\Claude`\n   - macOS: `~/Library/Application Support/Claude/`\n   \n   You can also find these directories inside the Claude Desktop app: Claude Desktop \u003e Settings \u003e Developer \u003e Edit Config\n\n2. Create or edit `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"airtable\": {\n      \"command\": \"npx\",\n      \"args\": [\"@felores/airtable-mcp-server\"],\n      \"env\": {\n        \"AIRTABLE_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\nNote: For Windows paths, use double backslashes (\\\\) or forward slashes (/).\n\n### Method 2: Using mcp-installer:\nmcp-installer is a MCP server to install other MCP servers.\n1. Install [mcp-installer](https://github.com/anaisbetts/mcp-installer)\n2. Install the Airtable MCP server by prompting Claude Desktop:\n```bash\nInstall @felores/airtable-mcp-server set the environment variable AIRTABLE_API_KEY to 'your_api_key'\n```\nClaude will install the server, modify the configuration file and set the environment variable AIRTABLE_API_KEY to your Airtable API key.\n\n### Method 3: Local Development Installation\nIf you want to contribute or modify the code run this in your terminal:\n```bash\n# Clone the repository\ngit clone https://github.com/felores/airtable-mcp.git\ncd airtable-mcp\n\n# Install dependencies\nnpm install\n\n# Build the server\nnpm run build\n\n# Run locally\nnode build/index.js\n```\nThen modify the Claude Desktop configuration file to use the local installation:\n```json\n{\n  \"mcpServers\": {\n    \"airtable\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/airtable-mcp/build/index.js\"],\n      \"env\": {\n        \"AIRTABLE_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Verifying Installation\n\n1. Start Claude Desktop\n2. The Airtable MCP server should be listed in the \"Connected MCP Servers\" section\n3. Test with a simple command:\n```\nList all bases\n```\n\n## Features\n\n### Available Operations\n\n#### Base Management\n- `list_bases`: List all accessible Airtable bases\n- `list_tables`: List all tables in a base\n- `create_table`: Create a new table with fields\n- `update_table`: Update a table's name or description\n\n#### Field Management\n- `create_field`: Add a new field to a table\n- `update_field`: Modify an existing field\n\n#### Record Operations\n- `list_records`: Retrieve records from a table\n- `create_record`: Add a new record\n- `update_record`: Modify an existing record\n- `delete_record`: Remove a record\n- `search_records`: Find records matching criteria\n- `get_record`: Get a single record by its ID\n\n### Field Types\n- `singleLineText`: Single line text field\n- `multilineText`: Multi-line text area\n- `email`: Email address field\n- `phoneNumber`: Phone number field\n- `number`: Numeric field with optional precision\n- `currency`: Money field with currency symbol\n- `date`: Date field with format options\n- `singleSelect`: Single choice from options\n- `multiSelect`: Multiple choices from options\n\n### Field Colors\nAvailable colors for select fields:\n- `blueBright`, `redBright`, `greenBright`\n- `yellowBright`, `purpleBright`, `pinkBright`\n- `grayBright`, `cyanBright`, `orangeBright`\n- `blueDark1`, `greenDark1`\n\n## Contributing\n\nWe welcome contributions to improve the Airtable MCP server! Here's how you can contribute:\n\n1. Fork the Repository\n   - Visit https://github.com/felores/airtable-mcp\n   - Click the \"Fork\" button in the top right\n   - Clone your fork locally:\n     ```bash\n     git clone https://github.com/your-username/airtable-mcp.git\n     ```\n\n2. Create a Feature Branch\n   ```bash\n   git checkout -b feature/your-feature-name\n   ```\n\n3. Make Your Changes\n   - Follow the existing code style\n   - Add tests if applicable\n   - Update documentation as needed\n\n4. Commit Your Changes\n   ```bash\n   git add .\n   git commit -m \"feat: add your feature description\"\n   ```\n\n5. Push to Your Fork\n   ```bash\n   git push origin feature/your-feature-name\n   ```\n\n6. Create a Pull Request\n   - Go to your fork on GitHub\n   - Click \"New Pull Request\"\n   - Select your feature branch\n   - Describe your changes in detail\n\n### Development Guidelines\n\n- Use TypeScript for new code\n- Follow semantic commit messages\n- Update documentation for new features\n- Add examples for new functionality\n- Test your changes thoroughly\n\n### Getting Help\n\n- Open an issue for bugs or feature requests\n- Join discussions in existing issues\n- Ask questions in pull requests\n\nYour contributions help make this tool better for everyone. Whether it's:\n- Adding new features\n- Fixing bugs\n- Improving documentation\n- Suggesting enhancements\n\nWe appreciate your help in making the Airtable MCP server more powerful and user-friendly!\n\n## License\n\n[MIT](LICENSE)\n\n---\n\nMade with ❤️ by the Airtable MCP community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelores%2Fairtable-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelores%2Fairtable-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelores%2Fairtable-mcp/lists"}