# Airsurf

> Airsurf is a free MCP server for productivity. MCP server giving AI clients search, read and write access to an Airsurf workspace. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://airsurf.app/developers/ecosystem
- **MCP Registry name:** app.airsurf/airsurf
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-20

## About

The Airsurf MCP endpoint is the Ecosystem API exposed as tools for AI clients such as Claude, ChatGPT and Cursor. Once connected, a client can search documents, issues, projects, calendar events and designs together, read items in full, file and update issues, and create or edit docs and database rows. It acts as the person who connected it and only offers tools that the integration's scopes and products permit.

Access is controlled per integration. Scopes separate read, write, object sync, event feed and action permissions, so an agent can be given only what it needs. Clients that support OAuth can sign in directly with the server address, while others use a bearer secret created in Settings.

The endpoint is aimed at teams that already keep their work in Airsurf and want an assistant to query or update it. The Ecosystem API itself is free on every plan, with rate limits of 10 requests a second per integration.

## Features

- **Scoped workspace access:** Tools are offered only for the scopes and products an integration was granted.
- **Search and read:** Search across documents, issues, projects and calendar, then fetch items in full.
- **Issue management:** Create, update and comment on issues, and move them between statuses.
- **Database and doc editing:** Create and edit documents and database rows, with report and automation tools.
- **OAuth or secret sign-in:** Clients can sign in with OAuth or use a bearer secret from a server.

## Good for

- Asking an AI assistant to find related issues and documents across a workspace
- Filing a batch of issues from a meeting summary in an AI client
- Keeping a project's status updated from an agent working in the same workspace
- Linking pull requests or support tickets to the issues they concern

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http airsurf https://airsurf.app/api/v1/eco/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://airsurf.app/api/v1/eco/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "airsurf": {
      "url": "https://airsurf.app/api/v1/eco/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "airsurf": {
      "type": "http",
      "url": "https://airsurf.app/api/v1/eco/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "airsurf": {
      "serverUrl": "https://airsurf.app/api/v1/eco/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://airsurf.app/api/v1/eco/mcp
```

Enter a Name (for example "Airsurf"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "airsurf": {
      "type": "http",
      "url": "https://airsurf.app/api/v1/eco/mcp"
    }
  }
}
```

## Tools

- `search`: Search across workspace products and apps' objects.
- `fetch`: Return an item's title, text, URL and metadata.
- `create_issue`: File a new issue in a team.
- `update_issue`: Change an issue's fields or status.
- `create_doc`: Create a new document.
- `edit_doc`: Edit an existing document.
- `comment`: Add a comment to an item.
- `list_calendar_events`: List calendar events.

## FAQ

### Does the MCP server cost extra?

The Ecosystem API and MCP endpoint are free on every plan, with no charge per request or run.

### How do I connect a client that does not support OAuth?

Create an integration in Settings → Ecosystem → Developers and send its secret as a Bearer token in the Authorization header.

### What can the agent access?

Only what the integration's scopes and products allow, acting with the permissions of the person who made it. Mail is never reachable through the integration.

### How do I add Airsurf to Claude Code?

Run this command in your terminal: claude mcp add --transport http airsurf https://airsurf.app/api/v1/eco/mcp

### What are the best alternatives to Airsurf?

The closest alternatives to Airsurf are Orangescrum MCP Server, gitscrum-core, Workspace369, Monday Com and Docspace.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Orangescrum MCP Server](https://ai-powered.com/mcp/orangescrum-mcp-server): Orangescrum MCP Server is an MCP server for productivity.
- [gitscrum-core](https://ai-powered.com/mcp/gitscrum-core): gitscrum-core is an MCP server for productivity.
- [Workspace369](https://ai-powered.com/mcp/workspace369): Workspace369 is an MCP server for sales and crm.
- [Monday Com](https://ai-powered.com/mcp/monday-com): Monday Com is an open-source MCP server for productivity.
- [Docspace](https://ai-powered.com/mcp/docspace): Docspace is an open-source MCP server for files and documents.
- [Syntra PMO](https://ai-powered.com/mcp/syntra-pmo): Syntra PMO is an MCP server for productivity.
- [Atrix AI](https://ai-powered.com/mcp/atrix-ai): Atrix AI is an MCP server for productivity.
- [42min](https://ai-powered.com/mcp/42min): 42min is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/airsurf
