https://github.com/hmk/attio-mcp-server
https://github.com/hmk/attio-mcp-server
Last synced: 11 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/hmk/attio-mcp-server
- Owner: hmk
- License: bsd-3-clause
- Created: 2025-02-01T16:55:46.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-07T02:45:04.000Z (9 months ago)
- Last Synced: 2025-04-12T08:14:24.939Z (8 months ago)
- Language: JavaScript
- Size: 96.7 KB
- Stars: 6
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - attio-mcp-server - An MCP server that allows AI clients to manage records and notes in Attio CRM via Model Context Protocol. ([Read more](/details/attio-mcp-server.md)) `crm` `attio` `ai-integration` `open-source` (Business & Commerce MCP Servers)
- awesome-mcp-servers - hmk/attio-mcp-server - AIクライアントがAttio CRMでレコードとノートを管理可能 (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
- awesome-mcp-zh - hmk/attio-mcp-server
- awesome-mcp-servers - hmk/attio-mcp-server - 📇 ☁️ Allows AI clients to manage records and notes in Attio CRM (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - Attio MCP Server - Connects Claude (and similar clients) to the Attio CRM API for reading and writing company data (Table of Contents / Workflow Automation)
- awesome-mcp-servers - hmk/attio-mcp-server - AIクライアントがAttio CRMでレコードとノートを管理可能 (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
- metorial-index - Attio MCP Server - Connects to the Attio API to read and write company records and notes for CRM management. (CRM and Sales Tools)
- awesome-mcp - hmk/attio-mcp-server - Allows AI clients to manage records and notes in Attio CRM (MCP Servers / 🛠️ Other Tools and Integrations)
- toolsdk-mcp-registry - ✅ attio-mcp-server
- awesome-mcp-servers - **attio-mcp-server** - Node.js-based `javascript` `typescript` `mcp` `server` `http` `npm install hmk/attio-mcp-server` (🌐 Web Development)
README
# attio-mcp-server
This is an MCP server for [Attio](https://attio.com/), the AI-native CRM. It allows mcp clients (like Claude) to connect to the Attio API.
#### Current Capabilities
- [x] reading company records
- [x] reading company notes
- [x] writing company notes
- [ ] other activities
## Usage
You will need:
- `ATTIO_API_KEY`
This is expected to be a *bearer token* which means you can get one through the [API Explorer](https://developers.attio.com/reference/get_v2-objects) on the right hand side or configure OAuth and retrieve one throught the Attio API.
### Claude Desktop Configuration
```json
{
"mcpServers": {
"attio": {
"command": "npx",
"args": ["attio-mcp-server"],
"env": {
"ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
}
}
}
}
```
## Development
### Prerequisites
Before you begin, ensure you have the following installed:
- Node.js (recommended v22 or higher)
- npm
- git
- dotenv
### Setting up Development Environment
To set up the development environment, follow these steps:
1. Fork the repository
- Click the "Fork" button in the top-right corner of this repository
- This creates your own copy of the repository under your Github acocunt
1. Clone Your Fork:
```sh
git clone https://github.com/YOUR_USERNAME/attio-mcp-server.git
cd attio-mcp-server
```
1. Add Upstream Remote
```sh
git remote add upstream https://github.com/hmk/attio-mcp-server.git
```
1. Copy the dotenv file
```sh
cp .env.template .env
```
1. Install dependencies:
```sh
npm install
```
1. Run watch to keep index.js updated:
```sh
npm run build:watch
```
1. Start the model context protocol development server:
```sh
dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
```
1. If the development server did not load the environment variable correctly, set the `ATTIO_API_KEY` on the left-hand side of the mcp inspector.